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s I write this, COMDEX (Computer Dealers' Exposition) is taking place in Chicago. This is where all 
computer-related manufacturers display their wares for buyers and media people, and the news is that 
Atari is there in force to promote their products. 

Atari has had its ups and downs at these computer shows: In better times they would find their way 
into the "highlight films" of journalists' coverage, while at other times they wouldn't even attend the 
show because they had nothing new to announce and felt their money was better spent elsewhere. 

This COMDEX brings word of new Atari products, a welcome change of the past few years. One 
of the products, Folio, is an attempt to add some spice to the MS-DOS world by creating an inexpen- 
sive, hand-held IBM-compatible computer— "about the size of a Walkman," as the press release reads. 
This refines the concept of a laptop, allowing salesmen and other on-the-road executives to easily bring 
a computer with them on their travels. 

The more exciting COMDEX news for long-time Atari fans, though, is the showing of Stacy, the ST 
laptop. Although isolated within a glass case to protect it from the hands of passers-by, it is actually 
there for all to see— unlike their invitation-only showings of the past. Atari is also pitching a DTP (desktop 
publishing) system, which includes an ST, a Postscript-compatible laser printer (a plus for compatibili- 
ty with other brands of computers and software), a hard drive and a cache of 35 fonts. Certainly this 
is good news for all Atari owners, as it ap- 
pears to be a sign of Atari's return to seri- 
ous U.S. marketing. 

Along those lines, the word from the 
rumor mill — which has been unnerving- 
ly silent since Atari altered their market- 
ing stance by maintaining silence about 
products until they are ready to ship — 
tells of the TT, the enhanced ST com- 
puter. Though it's too early to venture ex- 
actly what will be under the hood. Atari 
has proven their knack for innovation, 
even if they seem to lack crucial insight 
on marketing their products after they hit 
the shelves. 

Another exciting development is a 
revolutionary MIDI keyboard being devel- 
oped by Atari with the help of Mick Fleet- 
wood, one of the leaders behind the rock 
group Fleetwood Mac It's rumored to be 
so intuitive that it may change the method 
and speed with which people learn music 
As the ST-LOG staff consists of many mu- 
sicians, both professional and amateur, 
we're pretty excited about the possibilities. 

Of course, as these products are re- 
leased and hit store shelves, STLOG will 
be here to present evaluations for you, so 
you can best decide if they are something 
you'd like to add to your computer den. 
In the meantime, we sit on our hands in 
anxious anticipation of the "next gener- 
ation" machine's appearance on our 
doorsteps.! 
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BY ARTHUR LEYENBERGER 



I just received the latest edition of 
MichTron's Griffin Gazette. This newsletter 
is published quarterly and is packed with 
information on new products, hints and 
tips for MichTron's products and special 
deals for owners of their software. If you 
haven't seen it, you ought to take a look. 

Granted, the Gazette is a vehicle for ad- 
vertising MichTron's own products, but it 
goes beyond that. The particular issue I 
have in front of me is an excellent exam- 
ple of the type of quality support that ST 
software publishers should provide. This 
is a class act! 

For example, owners of Microdeal's Air- 
ball will find some hints on how to find 
the Spell Book, the goal of the game. In 
addition, an enclosed coupon entitles you 
to purchase Fleet Street Publisher for $50 
just by sending MichTron the copyright 
page of the manual from the DTP pro- 
gram you're currently using. If you are not 
yet using a DTP program, you can buy 
Fleet Street for 25% off the retail price. 

As you may know, MichTron is now dis- 
tributing HiSoft BASIC instead of GFA BAS- 
IC. If you already own GFA BASIC, you can 
purchase HiSoft BASIC or HiSqft BASIC 
Professional for half price, again by send- 
ing the copyright page of the GFA manu- 
al. The Gazette also includes information 
on other new MichTron products such as 
ProText, a fully integrated word processor; 
Michtron BBS Version 3.0; Fleet Street Pub- 
lisher 2.0; Hyperfont, a GEM-based font edi- 
tor; HiSoft BASIC; and Grail, a new 
adventure game. 

If you are a registered user of any 
MichTron or Microdeal product, you 
should already be getting the Gazette free 
of charge. If not, give MichTron a call at 
(313) 334-5700. Some of the deals men- 
tioned above may no longer exist by the 
time you read this. In any case, I com- 
mend MichTron for this effort and en- 
courage other software publishers to 
follow their example. 



Epyx power 

Although it has been available for 
awhile. Art & Film Director from Epyx has 
been sitting in my pile of software to be 
looked at real soon now. I have finally had 
a chance to open the package and play 
with it for a considerable time. I am 
definitely impressed with this product! 

Art SsfFilm Director was originally creat- 
ed a couple of years ago and was to be 
sold by Broderbund Software. Broder- 
bund never released the product and in 
the meantime, Epyx has picked up the 
rights and released it. Art & Film Director 
is really two products in one that allows 
you to create graphic screens which can 
then be animated. 

Art Director is a full-featured paint pro- 
gram that provides you with the tools to 
produce 16-color works of art. Color cy- 
cling can be used to display up to 128 
colors at once. Like other ST paint pro- 
grams, on screen menus and icons make 
it easy to select from a variety of geomet- 
ric shapes or draw freehand. Free-hand 
painting can be done using "spray cans" 



or one of 40 pencil nibs in different sizes 
and shapes. 

You can manipulate parts of your pic- 
ture in a number of different ways. The 
Bulge feature lets you create either a con- 
cave or convex effect and wrap an image 
around a sphere. Spin will rotate a square 
or rectangle around either a vertical or 
horizontal axis. The Sprite feature lets 
you define a circle and bounce it around 
the screen. 

Other features include shadowing for 
three-dimensional effects, using a portion 
of the picture as a paint brush or fill pat- 
tern and perspective. The program also 
makes creating or changing details easy 
with multiple levels of zoom and a "win- 
dow" feature that allows a specific work 
area to be blocked and changed without 
affecting surrounding areas. Two separate 
screens can be worked on at once or com- 
bined in several ways. 

Film Director lets you add the animation 
to bring your creations to life. Easy-to-use 
menu-based commands let you place 
characters, props, etc., on a frame and 
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then link the frames together to make a 
film. In addition, built-in music and 
sound effects are available to add the 
finishing touch to your "film." 

The program uses eel animation to let 
you modify a portion of a frame without 
tediously redrawing the entire frame. 
Notable is the "tweening" feature that au- 
tomates the process of animation right 
before your eyes. It's as simple as defin- 
ing the starting and ending points — the 
program then automatically generates ev- 
ery image in between. 

Art Film Director comes with four 
disks (two for each of the two programs) 
and an excellent manual. The documen- 
tation includes a tutorial and a quick 
reference section for both of the pro- 
grams. A nice touch is the information 
describing how to record your animation 
sequences on video. 

Included in the package is a program 
to convert DEGAS and Neochrome files into 
Art Director's .ART file format. Sample files 
are also provided that contain ready 
made art and animation sequences. These 
are especially helpful for learning how to 
harness the power of the program. 

The powerful Art (sf Film Director pack- 
age sells for $80 and is available from 
Epyx, 600 Galveston Drive, Redwood City, 
California 94063. They can be reached at 
(415) 368-3200. Art (sfFilm Director is a top- 
notch product that really shows off what 
the ST can accomplish. If you yearn to be 
creative with your ST, I highly recommend 
this program. 

6ame fever 

Over the years there have been a num- 
ber of games that I have found particu- 
larly addicting. Titles such as Missile 
Command, Space Invaders, Pac-man, Boulder 
Dash, Seven Cities of Gold, Time, Bandits, 
Mean 18, Arhanoid and Tower Toppler come 
to mind. To one degree or another, I have 
played all of these games for hours on 
end. They are challenging, fun and, yes, 
addicting. 

A new game has recently captured my 
interest. So far, I estimate that I have 
logged over 100 hours playing it. It is 
Tetris, from Spectrum Holobyte, and is 
one of the most enjoyable games I have 
ever played on any computer. 

Like many of the games mentioned 
above, Tetris is simple in concept. Basically, 
it's a game of eye-hand coordination. The 
goal is to rotate and position various- 
shaped blocks that fell from the top of the 
screen into a solid row at the bottom. 



When a solid row is formed you are 
awarded points and it disappears. Gaps 
often are left in a row, especially at the 
higher game levels, which causes rows to 
build up line by line. The game ends 
when there is no more room for blocks 
to fall. Since the specific shapes appear 
in random sequence, strategic thinking is 
required and frequently the fate of a 
game rests on how you decide to play a 
particular block. 

When the shapes appear at the top of 
the screen, you rotate and maneuver them 
with either the arrow keys or the J, K and 
L keys on the keyboard. The spacebar is 
used to drop the piece to the bottom of 
the screen once you have the piece in the 
right orientation and position. The faster 
you drop the pieces the more points you 
get- 
After a set number of rows have been 
completed, the game moves to the next 
level {Tetris offers pine levels of play) 
where the pieces fall at a faster rate. You 
can begin the game at a higher level, 
either at the start or any time during the 
game. For additional challenge, you can 
start the game with up to seven random- 
ly created rows already on the screen. 
More starting rows means a potentially 
higher score. 

Each new screen has a different back- 
ground graphic, including Mayday 
celebration at Red Square, Matinee at Bol- 
shoi Theater, view of Earth from Solyut 
Space Station and game day at Lenin 
Stadium. Although the backgrounds are 
incidental to the actual game play, they 
are well-designed and detailed. 

Sound effects can be turned on or off, 
statistics can be displayed on screen show- 
ing the number of each shape positioned 
and a help menu is available Another fea- 
ture allows you to display the next piece 
that will fall. Using this feature is manda- 
tory if you want to get high scores. A high- 
score screen is also available which shows 
the top-ten comrades and scores. 

Tetris was invented by a 30-year-old 
Soviet researcher named Alexi Paszitnov 
who currently works at the Computer 
Centre (Academy Soft) of the USSR 
Academy of Scientists in Moscow. The 
original programmer was 18 year-old Vag- 
im Gerasimov, a student studying Com- 
puter Informatics at Moscow University. 
Tetris has been called the software equiva- 
lent of the Rubik's Cube. Even closet 
gamers will enjoy it, given the quality of 
the game and its simple, yet addicting, 
nature. 



The ST version of Tetris sells for |40 
and is available from Spectrum Holobyte, 
2061 Challenger Drive, Alameda, Califor- 
nia 94501. Call (415) 522-3584 for more 
information. 

As much as I enjoy Tetris, it is a two- 
dimensional game. Blocks can be moved 
left and right, rotated and dropped. I 
would love to see (and play) a three- 
dimensional version. In addition to mov- 
ing blocks left and right, a 3 D game 
would allow them to be moved forward 
and backward. Further, they could be ro- 
tated front-to-back as well as counter- 
clockwise. 

Think of it: You would have to form not 
only a solid row but a complete set of 
rows on the bottom level before it would 
disappear and get points. Perhaps as each 
row is formed, you could position it any- 
where in the front to-back space. A 3 D 
Tetris would be really challenging. Are 
there any software authors out there will- 
ing to take on this challenge? ■ 




Arthur Leyenberger is a computer analyst 
and freelance xmter living in beautiful New Jer- 
sey. He can be reached on CompuServe at 
71266,46 or on DELPHI as ARIE. 
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#443 . Intersect RAM Baby (RAM Disk/Print Spooler) 

#456 - Bolo Breakout Game from Germany (1 Meg) 

#470 - Two Virus Killer Utilities. Database and more 

#475 - Werty s House of Horror (Adult Game, Color) 

#493 - Statistically Accurate Baseball V2.0 

#499 - The Accessory V1.2 - Multifunction Accessory 

#500/600 - Publishing Partner Fonts 

#511 - Dungeon Master Maps for Levels 1-7 

#512 - Dungeon Master Hints/Character 

#555 - The Assistant Chef Electronic Cookbook 

#557 - Ctiildren's Programs (Color Only) 

#567 - Accessories - Disk Full of Nevxest OA's 

#575 - Sheet V2,0 - Shareware Spreadsheet 

#588 - Pac Man, Hangman and 5 others (Color Only) 

#590 - Dungeon Master Utilities 

#599 - PageSlream Fonts, Font Converter 
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Shipping $2 50 Ground / $4 00 2nd Day Air 
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Desktop Mixing 

Steinberg/Jones, a company well 
known for their MIDI software, has just an- 
nounced a new product that may be the 
next step into the future for the computer/ 
music combination. MIMIX is a multi- 
channel software-based mixing console 
that offers a screen display including 42 
VGA levels, 34 VU meters and 180 vari- 
ous switches, all of which may be manipu- 
lated with the mouse. 

Audio signals are displayed using a 
needle meter with an LED peak indicator 
or using a bar graph with a peak hold 
meter Each channel on the mixer fea- 
tures a real-time VU meter; mute, solo 
and solo defeat switch; read/write update 
mode; VGA level; and a 24-character 
name. 




The hardware portion of the system is 
the MIMIX VGA Module, which is con- 
tained in a 19-inch rack-mountable unit 
and includes a real-time noise gate with 
ten programmable parameters. The 
MIMIX system can handle eight of the 
VGA Modules. 

The MIMIX system contains too many 
features to list here; anyone interested 
should contact Steinberg/Jones. But you'd 
better look at the prices first: $5,995 for 
the 16-channel system and a whopping 
$19,995 for the full 64-channel system. 

Steinberg/Jones 
17700 Raymer Street, Suite 1002 
Nortliridge, CA 91325 
(818) 993-4091 

CIRCLE #130 ON READER SERVICE CARO. 

Extra serial ports 

db Technology has announced the 
availability of its dual-port serial interface 
for the ST computers. The SPIIST, which 
comes with standard DB25 connectors 
and data activity lights, offers baud rates 
of 50 to 38.4 kilobaud. With this unit 
comes the potential for multiuser bulletin 
boards, and future enhancements will ex- 
pand the capabilities to allow local area 
networks for up to 255 users. 

The retail price of the SPIIST is $129.95. 

db Technology 
P.O. Box 246 
Cottondale, AL 35453 

(205) 556-9020 
CIRCLE #131 ON READER SERHICE CARO. 




Dungeon helper 

Dungeon Master has the honor of be- 
ing the top-selling ST program of all time. 
People by the tens of thousands have 
ventured into its dank and dreary hall- 
ways, though not everyone who has sal- 
lied forth has managed to solve the many 
puzzles that block them from victory. 

But help is available from many 
sources, not the least of which is Gom- 
puter Publications, Unltd.'s Dungeon 
Master Adventurer's Handbook, a com- 
plete guide to this intriguing game. This 
concise 40-page volume includes com- 
plete descriptions of characters, magic 
spells, combat strategies and monsters, 
as well as thorough level-by-level over- 
views of the dungeons, including detailed 
maps. All objects and puzzles in the dun- 
geons are referenced, with each puzzle's 
solution included for those who find them- 
selves stuck. ,sF^ ^ 



Mouse playgrounil 

Gurtis Manufacturing Gompany has ad- 
ded the Gurtis Mouse Pad to its product 
line. The pad is of laminate construction 
with a nonslip surface that the company 
claims helps maximize accuracy, control 
and response, as well as extend roller ball 
life. 





The Dungeon Master Adventurer's 
Handbook is $8.95 and is available at the 
address below. 

Computer Publications, Unltd. 
P.O. Box 2224 
Arvada, CO 80001 
(303) 423-6805 
CIRCLE #132 ON READER SERVICE CARD. 



According to Tom Judd, president of 
Gurtis, "Anyone concerned with the ac- 
curacy, performance and longevity of their 
mouse needs a Gurtis Mouse Pad. We've 
developed a cost-effective, quality product 
that delivers precise cursor positioning 
and improves mouse performance." 

The Curtis Mouse Pad measures 8 x 
9.5 inches and is waterproof and stain 
resistant. Its nonskid backing keeps it 
from slipping on your desk's surface. The 
pad retails for $6.95. 

Curtis Manufacturing Company 
30 Fitzgerald Drive 
Jaffr«y, NH 03452 
(603) 532-4123 
CIRCLE #133 ON READER SERVICE CARD. 
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Leisure Suit Larry Is back 

Just when everyone thought it was safe 
to play adventure games again, Sierra an- 
nounced Leisure Suit Larry Goes Lool<ing 
For Love (In Several Wrong Places). If noth- 
ing else this game wins the coveted 
longest-software-title award. 

This time around Larry has hit it big in 
the lottery and takes a romantic cruise, 

The game was programmed 
using Sierra's new 
development system. 
Sierra Creative interpreter 
(SCI), which allows a 
full 320 X 200 graphics 
resolution and improved 
musical sound trades. 

visiting several tropical resorts. But, as we 
all know, nothing ever goes right for poor 
Larry and spies from several nations 
make sure that this adventure doesn't 
change that streak of luck. 

The author, Al Lowe, who reportedly 
spent several months researching this 
new story, says, "I included in this game 
every resort and cruise I've enjoyed, so 




the IRS would let me write off my last 
three vacations." 

The game was programmed using 
Sierra's new development system. Sier- 
ra Creative Interpreter (SCI), which allows 
a full 320 X 200 graphics resolution and 
improved musical sound tracks that can 
be routed to a Roland MT-32 sound 
generator or a Casio keyboard. Future 



Sierra adventures, including Police Quest 
II and Space Quest III, also will be deve- 
loped with SCI. 

Sierra On-line, Inc. 
Coarsegoid, CA 93614 
(209) 683-4468 

CIRCLE #134 ON READER SERVICE CARD. 
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More from PsygnosIs 

Psygnosis has just released an arcade/ strategy game for 
two players with the unlikely name of Captain Fizz Meets the 
Blaster-Trons. That's right, it's a game, not a science fiction 
serial from the '50s. 



Captain Fizz 
Meets the 
Blasler-Trens 
is priced at 
$29.95 



According to Psygnosis, if players have any intention of 
being successful in this quest, they must learn to play cooper- 
atively. "The collaborative nature of the game is no mere sur- 
face glitter; you simply can't win without planning a strategy, 
watching your partner's back and even— when the chips are 
really down— sacrificing your own life so that your fellow play- 
er may go on to serve the noble cause. If you take the atti- 
tude that it's every man for himself, then the Blaster-Trons 
will finish you off in no time at all." 

Captain Fizz Meets the Blaster-Trons is priced at $29.95. 

Psygnosis 
Distributed by 
Computer Software Services 
2150 Executive Drive 
Addison, iL 60101 
(312) 620-4444 
CIRCLE #135 ON READER SERVICE CARD. 
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ProCopy 



ST 
BACKUP I 
UTILITY 

You can't backup your software 
because copy protection locks 
you out. ProCopy is thie key! 

■ Protects against ttie accidental loss of 
expensive software 

■ Works with all Atari STs 

■ Copies both S/S & D/S disks 

■ Use with 1 or 2 disk drives 

■ Not copy protected 

■ FREE shipping and handling 

■ TOLL-FREE telephone number 

■ Updates available to registered owners 

■ Orders shipped same day 

* Disk analy ze function included 

and CCD. 
orders 



Dealer 
Inquiries 
Welcome 



CqII (800) 843-1223 ^ 34'^^ 

Send check for S34.95 (overseas add S2.00 for air mali) to- 

PROCO PRODUCTS 



lAvailabie 

lln Europe 



P.O. BOX 665, CHEPACHET, RHODE iSLAND 02814 USA 
(401) 568-8459 

THE MOVING FINGER CO. TECH-SOFT 

Building 2 COiVIPUTER WHOLESALE 

Shamrock Quay 324 Stirling Highway 

Southampton, SOl-lQL Claremont 

T-r JllSL°2S„ Western Australia 6OI0I 

TeL 0703-229041 Tel. 09-385- 1885 

CIRCLE #102 ON READER SERVICE CARD. 
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It makes you want to tear your ha» out— what little you might have left. 

Just a few years ago a reviewer was safe; 
overseas software never appeared in the 
States. You could wait months on end to 
mention a product, and still, fe\sjf any, 
American ST users would have he 

But now that's all changed. Now pro- 
grams flow like quicksilver between Eu- 
rope and our home — so quickly that it 

confronts us with a problem. 
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Remember how in the last column 
Batman — 71ie Gaped Crusader (Ocean Sofi- 
ware) had just appeared in its small Brit- 
ish box with two disks and a free poster 
that had the nmltil;in>ruagc directions on 
the back? You can Ix-t that it's a hoi topic 
right now, what with all the aiteiiiion 
directed at "Pointy Ears" due to the inajor 
motion picture bearing his name — and 
this being his 5()th anniversary. In the 
time since 1 wrote that hist ( oUiniii, Daia 
k£ast has acquired distribution rights for 
Batman and released il, making it the 
review territory of other columnists. So, 
let's lake a peek at Aflerlmmer instead. 

Activision U.K. has done a great job of 
capturing the feel of this rnega-arcade hit 
from Sega: great music every step of the 
way, nifty sound effects and a digitized 
voice. You even get a poster and arm 
patch. 

Afterburner places you behind the cock- 
pit of a lean, mean F14. The two-di 
boot-up runs some fancy graphics whili 
you ponder options of music, sound ef 
fects and the sensitivity of the mouse 
control. 

All controls are handled using the 
mouse — banking from left to right and 
diving or climbing, accelerating and fir- 
ing (keyboard options are also available). 
^^■^^^feHHHfeHM^^^^^^^^^ try rolling 
^^^^^W^^^^W^np^ninilanuever will 
aid you in avoiding enemy aircraft and 
missiles approaching from behind — those 
that the flashing warning lights alerted 
you to. 

I The graphics are good; realistic enough 

1 to get the job done, while moving at a fast 

rate to keep the game from becoming 
boring (I would have liked a joystick op- 
tion though). The background tune keeps 
the pace throughout each stage of the 
game, with sound effects having just the 
right kerblam and whaboom. Once off tlie 
deck of the aircraft carrier, make sure you 
don't run out of missiles or overheat your 
laser cannons. ^ 

It's worth noting lor hand-held game 
fans that Tiger Electronics li^l) version 
of Afterburner (complete with % -sized 
ipyilick and flashing lights) should be 
available by the time you read this. 

Dragonscape (Software Hoii/ons) con- 
tinues the theme ol arcade action. Fly 
your pet dragon, t.aivin, thiough the 
realm of Tuvania, collecting and distribut- 
ing vital artifacts along the way Smooth- 
lyanimaled, Garvin can lac e in any ol Ki 
directions. Five separate areas will scroll 
past you; the Wastelands, Woodlands, 
Icelaiids, Techno City and Arcadia. Kadi 
level is eight screens, with plenty of sur- 





Activision U.K. 




Activision U.K. 
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prises — such as the evil King of Chaos, 
who has dispatched his evil legions to 
hamper you (kill you, to be exact). 

Twenty different enemies appear at 
each level, with a super baddie making his 
debut should you survive lonj^ t nongh. 
Meanwhile, traps have been l.iid lo boili 
delay and confound you, so just don i pit k 





up everything that i,sn'i nailed down! Yet 
somehow you must lind and correctly 
place the eight key ob|i i is m ordci to e nd 
the Curse of C-liaos. Did I nicnlion the 
mazes surrounding sonii- oi Mu- ;n lilai (.s? 
Sorry. 

On a more serior s note, Master SouiuJ. 
(also Software Horizons) turns you on lo 



: • Psygnosis 



the power of sampling at a low price (list 
is approximately $50). Features of this 
liaidware/software package include vari- 
able automatic recording, filtering, com- 
|)rcssion of sounds and fading. 

.Sain|)lcd sounds may be sequenced, 
edited and assigned to one of 18 differ- 
ent presets, and then played back in real- 




KROM OVER THE BIO WATER 



time. The package goes the distance by 
also including a utility screen that can dis- 
play sounds along with user controlled 
scrolling messages and animated accom- 
paniment. Add to that a real-time VU 
meter, oscilloscope and 34-bar spectrum 
analyzer. 

Now let's turn our attention to Sprite 
Master from Soft Bits. For those who may 
not know, sprites are those creations that 
move on screen: aliens, cute little guys, 
even explosions. Sprite Master lets you de- 
sign your own sprites in low resolution, 
ranging from a tiny 16x16 pixel-sized 
figure on up to massive 144 x 84 version 
—and all using a full 16 colors. Created 
sprites are saved as a "series," a file that 
is similar in many ways to the frames of 
a film. Memory and the size of the sprite 
will determine the number of frames in 
a file — the more frames, the smoother the 
animation. 

The editing screen is where sprites are 
born. Split into three sections, the left 
side is an enlarged view of the full sprite. 
Below to the right can be found the draw- 
ing/editing controls. These include many 
of the conventional drawing tools (pen, 
lines, box, fill, etc.), plus copy flip, rotate, 
resize and palette control. Sprites are 
saved in memory with an individual 
frame number and color palette. Func- 
tions are de-selected easily with the right 
mouse button, and the finished file can 
be previewed and "stepped" through in 
a different screen. The speed of the 
frames can also be varied. 

Soft Bits also includes Picmaster, a pro- 
gram that loads picture files and com- 
presses them to half size so that you can 
cut and paste them for sprite use. List- 
master, also included, converts data from 
Sprite Master into an ASCII format to use 
in BASIC programs. A thorough techni- 
cal information section brings up the rear 
of the book, and is appreciated. Sprite 
Master can't make you an artist, but it does 
provide the tools and elegant interface 
necessary for transferring those anima- 
tion ideas into reality. 

We conclude with a preview of two up- 
coming games from Psygnosis. Super 
Menace (tentative title) is indeed a super 
version of the popular Menace (and was 
written, in fact, by the same programmer). 
Those familiar with the game will find 
new excitement due to a horde of beasties, 
lots of color and both vertical and 
horizontal scrolling within the same lev- 
el. In addition, you are not limited to a 
single type of spacecraft; depending on 
the planet you're heading for, you could 
be commanding a jetpack, helicopter or 
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of the s| trite will 
determine Ihe number 
of frames in a file — 
the more \ rames, the 
smoot ler the 
anim ution. 




spaceship. It's shoot-em-up city folks! 

Blood Money, on the other hand, re- 
quires strategy as well as good reflexes— at 
least in the demo version I was viewing. 
You control a litde guy moving through 
a horizontally scrolling world of magic 
and evil. Use the tools you find to bring 
joy and light to all— maybe you'll then be 
allowed to take a ride on the dirigible that 
keeps passing overhead. 

See you next time. 




Marshal M. Rosenthal is a New York-based 
photographer and writer specializing in chil- 
dren with prodiwt, video graphic enhancements 
and high-tech entertainment. His written/pho- 
tographic projects have appeared in major pub- 
lications in England, France, Germany, Sweden 
and the U.S. 

Products mentioned: 

Afterburner 

Activision U.K. 

Blake House, Manor Farm Road 
Reading, Berks 
England RG2 OJN 

Blood Money 

Psygnosis, Ltd. 
First floor 

Port of Liverpool Building 
Liverpool, England L3 IBY 

Dragonscope 

Software Horizons 

5 Oakleigh Mews 

London, England N20 9QH 

Master Sound 

Software Horizons 

5 Oakleigh Mews 

London, England N20 9QH 

Sprite Master 

Soft Bits Software 

5 Langley Street 

London, England WC2H 9JA 

Super Menace 

Psygnosis, Ltd. 
First floor 

Port of Liverpool Building 
Liverpool, England L3 IBY 
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BY MAURICE JOLYNEAUX 

^jver the previous four installrfnts we've covered conceptualizing 
an idea, refining and storyboa Jing it. So you should have a fairly 
good idea of how the idea yo*want to animate will turn out. You 
have the "plot" and you have iie "script." That's a lot, but not quite 
enough. Unless you're doing f flying logo or something mechanical, 
you probably plan to have a c Aracter or two (or more) appear in your 
anijnation. Since you've storylfcarded the animation, it's possible that 
you've already designed any c^racters you'll need, but it isn't neces- 
sarily the case. Whether or noWou have any character design done 
probably depends on how detai^d your storyboarding and sketch- 
ing has been up until now. 

By the way, for the past two issues I used the ant and magnifying 
glass sequence to illustrate storyboarding, rather than using material 
from the music video I mentioned as my actual example project. I 
did this because it was simpler to illustrate the story and break down 
techniques with a sequence like that rather than trying to demonstrate 
it with the music video. The rough storyboards for that encompass 
over 70 drawings at the halfway mark! I'll return to the music video 
this time, but we'll keep our ant friend around for when we need him. 



Defining tiie character 

Even if you already have a good idea 
of how you want your character(s) to look, 
it's still a good idea to explore the possi- 
bilities to see if you can come up with 
something better. As with everything else 
in this process, the look of a character 
might give you some more ideas or sug- 
gest variations on existing ones. 

The first thing you need to do is list all 
the characters that appear in your anima- 
tion, and alongside their names specify 
character traits and all the details you 
know about them. You should try to form 
a mental picture of a character that fits 
the traits and the name. 

If they don't have names yet, give them 
names. Oddly enough, you'll probably 
find it easier to "relate" to these fictional 
beings if you give them a handle. Try to 
find a name that fits the type of charac- 
ter you have in mind. For example, the lit- 
tle ant character seen in the previous two 
installments is a rather smart character 
You don't picture him as big and brutish, 
so a name like Crusher or Ivan seems in- 
appropriate because they are "strong" 
names. You want something a little smart- 
er sounding. Then again, you don't want 
something too "brainy" sounding or you 
risk a name that implies nerd-dom. You 
need a good middle ground, but nothing 
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ordinary. Nobody remembers ordinary 
names, in film or in real life. People pay 
attention to names like Atari, Symbolics, 
Pixar and Rhythm & Hues, but aren't in- 
terested in names like Software Industries 
or Computer Data Systems, Inc The same 
goes with characters. A naine like George 
White doesn't say anything, as opposed to 
interesting names that fit the characters 
who wear them. Below are a few from 
some animated films, with a pat charac- 
ter summation. Note how the names fit 
these descriptions. 

Harry Canyon: Cab driver 

Elmer Fudd: A drip for all seasons. 

Hop Low: Dancing Chinese 

mushroom. 
Speedy Gonzales: Fastest mouse in 

Mexico. 

Wile E. Coyote: Cunning carnivore. 

See? Elmer Fudd is a dumb-sounding 
name, suited perfectly to the dolt who 
wears it. Hop Low sounds vaguely 
Chinese and implies movement and 
jumping, which the littlest dancing 
mushroom (from Fantasia) does. Harry 
Canyon is a pretty bland name, perfect for 
a grubby cabby in the 21st century; but 
it's unusual enough to be memorable. 



A convention in older cartoons and 
comics was to give characters names that 
were alliterative (meaning starting with 
similar sounds) or rhymed. Think about 
it. Alliterative names include Clark Kent, 
Lois Lane, Bugs Bunny, Mickey Mouse, 
Daffy Duck, Atom Ant, Secret Squirrel. 
Rhyming names include Foghorn 
Leghorn, Spike and Tyke and Magilla 
Gorilla. There are even "punny" names 
like Chip and Dale and Mac and Tosh! 

The song I am going to animate a video 
to is called "I Know You." The title, which 
is repeated numerous times in the song, 
is the inspiration for the animation. The 
line "I know you" implies recognition, 
and the song's verses reinforce this. Thus, 
the plot I came up with is a simple one: 
A little guy sees a good-looking lady, is ins- 
tantly smitten, thinks she was made for 
him and absolutely won't leave her alone. 
The title is repeated six times every chor- 
us, for a total of 36 times during the en- 
tire song. My image is of the lady trying 
to avoid the guy, and he pops up and 
points at her on every single "I know you." 
No matter where she runs, no matter what 
she does, he pops up — no matter how im- 
possible or improbable the location. No 
matter where she turns, he's there. 

The humor in the situation arises from 



his popping up from the most unexpect- 
ed of places. To provide myself with a 
veritable playground of possibilities, the 
video is set in a museum, allowing the guy 
to appear with sculptures, in paintings, 
out of ash trays, doors, lamps, fossils — 
anywhere! 

Within this framework you can see that 
the only kind of character that will work 
for this guy is an obsessive type, one who 
is oblivious to the fact that the object of 
his affections wants less than nothing to 
do with him. Also, he needs to be flam- 
boyant, hammy. As the unwilling target of 
his affections, the lady merely needs to be 
aloof and disinterested, without being 
completely cold. 

With regard to your own animation you 
should weigh the situations you've 
planned and find the key points to the 
characters there. Even if you've already de- 
fined your characters, it's useful to go 
through this step because you may find 
the personality type you've come up with 
doesn't work particularly well with the 
plot line you've established. For example, 
putting a meek little guy with easily 
bruised feelings into the video I have out- 
lined simply would not work without 
some major plotting overhauls. Seeing a 
poor guy rejected wouldn't be as funny as 



ST-LOG JULY 1989 



15 



ANIMATIOH STAND 



seeing an obnoxious guy get what he 
probably deserves (unless your gag 
material overcomes the inherent weak- 
ness of that character in the situation). 

I have to repeat this: I am aiming for 
funny You may not be and should not be 
unless that is specifically what you want 
and think is right for your project. Do 
what you want. My examples are just that: 
examples of the process. 

Designing the character 

Now that you understand the concept, 
I'll explain the character design. First of 
all, I knew right away the guy would be 
short and kind of unattractive and 
unfashionable — not ugly, but neither 
would he be tall or particularly hand- 
some. The lady would, naturally, be a 
knockout; so he would have sufficient rea- 
son to go instantly ga-ga over her. 

I wanted to get away from the classic 
cartoon style I'd used on Megabit Mouse. 
I wanted a kind of modern, angular look: 
very bold, with bright colors and hard 
lines — like a piece of modern art. The ef- 
fect I was after was somewhat minimalist. 
Small details would be omitted. The only 
things that would appear would be what 
was necessary to show. If the guy's hands 
weren't doing anything important, they'd 
be simplified to mere shapes, void of de- 
tails such as lines separating fingers. I pic- 
tured characters made up of geometric 
parts. Perhaps the guy would be made of 
round parts, the lady out of angular ones. 

Round lost out quickly because it didn't 
look energetic or interesting. The music 
is up tempo; the pace of the planned ac- 
tion is fast. Therefore I felt the best 
character design would be something 
bold and hard edged, something that 
would look good even in fast movements. 
Following this thinking, a suggestion was 
made to give the guy a square-shouldered 
look, almost like a zoot suit. My first in- 
clination WHS to give him a triangular 
body, rectangular limbs and wedge- 
shaped shoes. A sharply angled head 
didn't appeal to me, so I made his head 
and hands round. Figure 1 shows how I 
drew up a model of this concept on the 
ST to see what it would look like. 

I got the opinions of several friends on 
this model. We agreed that while the 
general concept was on target, there was 
room for improvement. The round head 
didn't look right. Someone commented 
that the tails I'd indicated on the bottom 
of the suit triangle should be separated. 
Everyone thought the coloring appropri- 
ately tacky (this dude has no taste in 
clothes). 



I whipped out a sketch pad and start- 
ed scribbling. I doodled the guy doing 
some dynamic things, to get a better idea 
if this model would work. I could see how 
splitting the tails on the suit could im- 
prove the look of the character. I also 
played around with a geometric head 
shape, but hated it. I finally compromised 
with a rounded-off triangular head, which 
seemed to fit the bold design without be- 
ing too harsh. I quickly drew a couple of 
these poses on the ST and realized I was 
getting closer. I began to think that the 
coloring on the guy's suit didn't clash 
enough; so I decided to try a check pat- 
tern made of green lines on the magenta 
suit and made the bow tie and shoes 
green also. As you can see in Figure 2, the 
suit pattern was always planned to be 
completely flat, with no effort taken to 
create an illusion of depth or to make the 
pattern "follow" the lines of the charac- 
ter's clothes. 

How can I sum up this look? Perfect! 
Perfectly tacky! 

Up to this point I had kept the guy's 
head blank — no ears, nose or mouth. The 
only face was made up of two horizontal 
lines for his eyes. This was in keeping with 
the minimalist ideal, but left his expres- 
sions rather flat. I experimented with his 
design a bit more, drawing him in a num- 
ber of postures and positions. I found out 
that even the most energetic and emotion- 
al poses were weak without a real face. I 
tried modifying these sketches, adding ap- 
propriate cartoon eyes. I refrained from 
adding any other details (the mouth 
would appear only when necessary, like 
if he smiled sheepishly). The cartoony 
eyes suddenly opened up his range of ex- 
pression, and he instantly gained an ap- 
peal the earlier designs had lacked. I 
tested these designs on the ST and the de- 
sign was finalized as in Figure 3. 

Well, more or less finalized. Small 
refinements will come when the first ani- 
mation is tried. When you start moving 
the character, you begin to find design 
flaws, which can usually, but not always be 
easily corrected (legs may need lengthen- 
ing, and so on). 

The lady proved to be a more difficult 
proposition. I had to try to make a bunch 
of angular shapes look like a good- 
looking woman. Not easy! It took a lot of 
sketching before I got something that 
worked. As with the guy, it wasn't enough 
for this woman to just look good. She had 
to be flexible enough to go through the 
motions required, stylistically match the 
guy, and look good. I couldn't make her 
in a completely different fashion. I want- 



ed graphic harmony, not discord! 

While such stylized characters are in 
some ways easy to work with, they tend to 
have a rather limited scope. Their range 
of movement and expression is curtailed 
by their simplified design. A frown 
doesn't come across well without a mouth, 
and sniffing is tough without a nose. 

A character like Megabit Mouse is 
another matter entirely. Like film car- 
toons of old, he is built up from round 
elements, which not only makes him cuter 
but also simplifies things because many 
of these building blocks maintain the 
same shape at any angle. To build shape 
tables of the guy in the music animation 
would require scores of different bodies 
in varying positions. Megabit's body is a 
sphere, which looks the same at any an- 
gle, so only one is needed (more if his size 
is to change). To give this ball-shaped 
body some direction a tummy spot is ad- 
ded (as a separate element), and his limbs 
are used to complete the illusion that 
there's more detail than actually exists. 

The ant discussed previously could be 
drawn in a number of ways. As to basic 
body structure, because he's an insect a 
segmented body (head, thorax and abdo- 
men) would be a good idea. The amo- 
unt of detail, modeling , or lack of it, 
would permit dozens of wild variations 
even within this basic structure. 

In the original rough storyboards, the 
ant had six limbs. By the revised boards 
(last issue) he had only four The extra two 
got in the way, would have complicated 
the animation and weren't really neces- 
sary. They just complicated the matter 
without adding anything, so I left them 
off Again, such decisions must be made 
on a case-by-case basis. If I'd storyboard- 
ed different actions I might have found 
the extra limbs useful and left them on. 
You'll have to decide what is desirable and 
what is better left out. 

If you look at Figure 3 again, you'll no- 
tice that one of the things I was doing in 
drawing all these poses was to get an idea 
of the character's range of flexibility: what 
kinds of expressions and postures I could 
expect to get. It was a way of exploring 
the limits of the character's flexibility be- 
fore committing a lot of time to an ani- 
mation test. I could see if the parts were 
proportioned correctly, fit together in the 
right way. It also let me see if the charac- 
ter looked good and gave me an idea of 
the possible appearance of the final 
product. 

There are a lot of different styles and 
approaches to character design; so many 
that to try to discuss even the most basic 
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forms would take more space than I have. 
Let's just say that styles in animation can 
vary as much as in any other graphic art. 
There are hundreds of different ap- 
proaches you can take for any given 
character, and in a lot of cases no one of 
those is the right one. 

I highly recommend generating test 
models of your characters on the ST as 
soon as you have a good idea of what 
they'll look like. You may find that the 
resolution and limited colors force you to 
make changes in your designs. This ap- 
plies no matter which program you are 
using. If you're generating 3-D model 
characters, try building a rough model to 
see if it looks okay. If using a more con- 
ventional paint/animation system, draw it. 
It's also useful to try to determine your 
color palette at this point. Normally we've 
got only 16 colors to play with, and you 
should endeavor not to waste any. In the 
case of the man and woman in the music 
animation, I was careful to draw them 
with only eight colors. The remaining 
eight can be changed to suit the needs of 
a specific shot. To keep this consistent I 
created a master-palette screen that lists 
all 16 colors and indicates which are 
reserved and for what purpose. 

Endless pose-abilities 

There's a dying art in animation known 
as character posing or just plain "posing." 
When you pose a character, you put the 
character in a position, posture and atti- 
tude that convey something about 
him/her or the situation they are in. For 
example, if you needed to scare a charac- 
ter, the first thing that most people would 
think of is drawing a wide open mouth 
and bulging eyes. AH fine and good, but 
it's not as effective as combining that ex- 
pression with body language, which can 
heighten the effect. When you're angry, 
you tense up. When you're sad, you tend 
to droop. People are very face-oriented, 
but if you look at most people, you'll no- 
tice that their body language can often be 
as revealing as the look they're wearing 
on their faces. 

Using poses in animation is a some- 
what tricky business. It requires you to 
find the pose that conveys the informa- 
tion you need, but at the same time will 
allow for a smooth transition into the 
next position (unless you want a complex, 
difiicult transition). It must also fit in the 
scene. This may not sound all that 
difficult until you try it. One of the most 
difficult shots I ever had to storyboard was 
posing the guy in the music animation as 
he knocked on a door, opened it and 
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leaned through the door frame. 

Probably the master of posing animat- 
ed characters is Chuck Jones, director of 
hundreds of Warner Bros, cartoons. He 
described an animator as an "actor with 
a pencil," a statement which he could well 
apply to himself His cartoons, particular- 
ly those dating from the late 1940s 
through the end of the 1950s, are beauti- 
fully staged, with expressive poses punc- 
tuating the situations and dialogue. The 
transitions between these poses are also 
excellent. You are not really aware that the 
poses are being struck, because they are 
integrated so well into the action. Refer 
to Figure 3 once again, and you'll see 
some relatively simple but effective pos- 
ing. The character's whole body reflects 
each of the expressions and makes them 
clearer to the audience. This is of great 
importance considering the rapid pace of 
most animations. You have to find the 
best way to convey the information as 
quickly and clearly as possible. 

Creating a series of poses and then go- 
ing back and adding the movements be- 
tween them is known as "pose to pose" 
animation. Animating a sequence from 
start to finish without using the pose to 
pose method is known as animating 
"straight ahead." The pose-to-pose tech- 



nique allows careful planning and well- 
staged and choreographed action. The 
straight-ahead method is more spontane- 
ous and sometimes results in more in- 
teresting output, though animating 
without a road map like this can also 
leave you with an unusable sequence. 



If you have multiple programs, 

you should weigh the 
capabilities of each and decide 
which program will allow you 

to do the iob with the least 
labor, and, more Importantly, 
which program will produce 
the best results. 



Due to space limitations there are a lot 
of subjects I can only touch upon. Posing 
is one of them. Some specifics related to 
posing within an animation, such as line 
of action and silhouetting action, we'll 
tackle when we get to the actual act of ani- 
mation. 



Which program? 

We're at the juncture where, if you 
haven't made up your mind already, you 
need to decide what program or pro- 
grams you'll be using to create your ani- 
mation. If you have multiple programs, 
you should weigh the capabilites of each 
and decide which program will allow you 
to do the job with the least labor, and, 
more importantly, which program will 
produce the best results. 

In the case of the music video, my plan 
is to animate the characters using Film 
Director, because it allows the greatest 
editing control and flexibility for eel ani- 
mations. But, I'm not stopping there be- 
cause speed is important as well, in 
addition to various "camera" moves 
planned into the video that Film Direc- 
tor cannot handle Thus, once the charac- 
ters are animated, the Film animation will 
(laboriously) be converted into a Delta file 
format and moved into Cyber Paint for 
polishing. Cyber Paint's playback is faster 
than Film's, plus it's video-effects-type 
tools will allow the addition of such ef- 
fects as motion blur, image distortions, 
and so forth. Several other programs will 
also be involved, including CAD-3D and 
Cyber Control (to plot out a rotating mo- 
bile), and an old ray-tracing utility (why.' 
I'm not telling yet!). On the hardware end, 
there's the Genlock I had installed in my 
ST last week (see Step I in this issue). 

Why all these tools? As I said at the be- 
ginning of this series, I come up with the 
idea first, then pick the tools to do the job 
The fact that I have to use a lot of them 
doesn't thrill me, but if there were an eas- 
ier way to do what I want, believe me, I'd 
do it. There's nothing wrong with doing 
it the easy way — as long as the easy way 
is the right way. As usual, in regard to your 
own project, you'll have to decide that for 
yourself. 

Next issue it's on to actual production 
stuff, as graphics start to form, and test 
animations begin. I'll also tell you about 
a neat tool, called a "pose reel," used for 
pretesting your animation. I 




Maurice Molyneaux couldn't think of 
anything smug or impressive to say about 
himself this month — but don't expect it 
to last long. 
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Open your own 
art department. 




If you're a desktop publisher with big 
ideas and a small crew, let Migraph 
staff the desktop art department of 
your dreams. 

Picture this: Professionally drawn 
images and illustrations at your finger- 
tips. Powerful drawing tools, extensive 
editing tools, and a complete paint 
program at your command. 

Plus high-quality printouts. Every time. 

All that and compatibility, too. Migraph 
files load easily into your favorite Atari 
ST publishing programs. 

Powerful. Versatile. And easy to use. 
Migraph's the ideal candidate for every 
job in your graphics department. 



Touch-Up The complete design tool for 
high-resolution monochrome images. 

Easy-Draw" The professional 
object-oriented drawing program. 

Supercharged Easy-Draw Easy-Draw 
plus basic publishing features. 

Easy-Tools A 5-tool GEM desk 
accessory to enhance Easy-Draw. 



DrawArt Professional A library of over 
150 professional line art drawings. 

Scan Art™ A library of over 100 
high-resolution, bit-mapped images. 

Border Pack A library of over 40 
attention-getting border designs. 

OSpooler A configurable background 
file spooler and print buffer. 

Whatever desktop graphics project you 
have in mind-be it big or small, simple 
or ornate, traditional or avant-garde- 
Migraph's got you covered. 



See your Atari ST' dealer today for more 
details. 



200 S. 333rd St., Suite 220 Federal Way, WA 98003 800/223-3729 206/838-4677 
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CIRCLE #103 ON RUDER SERVICE C«RD. 




icroCheck ST 



BY CLAYTON WALNUM 



four years since ANALOG Computing published the orig- 
inal version of my home-checking program, MicroCheck, and as amazing as 
it may seem, I still regularly get mail about it. It's not often that an author's 
first pubUshed work gets that kind of attention. 

Of course, because of the original MzcroC/iecic's popularity, nothing would 
do but that I sit down and write a version for the ST. "It'U only take about 
six months," I said to myself. 

Two years later. . . . 



•■ Note: Due to 
► the large size of 
^ this program, it is 
available only on 
this month's disk 
version or from 
the databases of 
- the ST-LOG ST 
* user's group on 
^ DELPHI. 
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To run MicroCheek ST 
from the desktop^ double- 
click on the file 
MICROCHK.PRG. (Make 
sure the file 

MICROCHK.RSC is in the 
same directory.) When the 
program has loaded, most 
of the screen will be filled 
with a window, and it is 
here that your check data 
will be displayed. 



Getting started 

To run MicroCheek ST from the desktop, 
double click on the file MICROCHK.PRG. 
(Make sure the file MICROCHK.RSC is in 
the same directory.) When the program 
has loaded, most of the screen will be filled 
with a window (see Figure 1), and it is here 
that your check data will be displayed. 
Across the top of the screen is the menu 
bar MicroCheek STs various functions can 
be accessed by selecting them from this 
menu or by pressing the equivalent key- 
stroke commands. (The keystroke required 
is shown next to each item in the menu. 
Hold down Control and press the ap- 
propriate key.) 

Across the bottom of the screen are six 
boxes that contain various information 
about your account. From left to right they 
are the account balance, the number of 
transactions, the number of checks and 
the number of deposits in the currently 
opened month, the month you're work- 
ing on and the date. Before an account 
is opened, most of these boxes will con- 
tain zeroes. 

The window contains scroll bars and ar- 
rows thai ■will allow you to see informa- 
tion that doesn't fit in the window. You 
use these in the normal GEM fashion, click- 



ing or dragging them with the mouse 
pointer Scrolling the window to the right 
will allow you to see the dates on the 
checks. All other information fits in the 
window. Vertically, the window will hold 
16 checks. If the window is fully opened 
by clicking on the full box in the upper 
right corner of the window, you can fit 20 
checks, but you won't be able to see the 
information boxes at the bottom of the 
screen. If you have more than this num- 
ber of checks in the current month's data, 
you can view them by moving the appropri- 
ate scroll bar or by clicking on the arrows. 

Setting the date 

MicroCheek ST uses the date shown in 
the date box for printing on reports. When 
the program is first run, it gets this date 
from the computer's system clock, so at 
the beginning of a MicroCheek ST session, 
you should make sure that the date shown 
in the date box is correct. If your ST has 
a battery-backed-up clock, or if you've al- 
ready set the ST's date from the desktop, 
the date shown in the date box should be 
okay. Otherwise, you'll need to set it 
yourself. 

To set the date, select the Date option 
from the Utilities drop-down menu or 



press Control-D on your keyboard. A small 
dialog box will appear Enter the new date 
in the form mm/dd/yy, and then click on 
the OK button to install the new date. 

If, after selecting the Date function, you 
decide not to change the date, you may 
cancel the operation by clicking on the 
dialog box's CANCEL button. 

Starting a new account 

The first thing you must do to use 
MicroCheek ST is create a new account. This 
procedure creates all of the files the pro- 
gram needs to keep track of your check- 
ing activity. You need to perform this 
process only once for each account you 
want to start. 

Most of you will have only one account 
on your data disk; however, you can have 
as many accounts on your disk as will fit. 
Keep in mind, though, that as you add 
transactions to an account, its files will get 
larger. Make sure you have enough room 
on the disk. An average home checking 
account needs about 50K of data space, 
plus an additional 72K for the MicroCheek 
ST program and resource files. 

To create an account, select New from 
the File drop-down menu or press Control- 
N. A dialog box will appear, prompting 
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To create an account, 
select New from the File 
drop-down menu or press 
Control-N. A dialog box 
will appear, prompting 
you for the personal 
information the program 
requires. Fill in your 
name and address and the 
starting balance for your 
account. 
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you for the personal information the 
program requires. (See Figure 2.) Fill in 
your name and address (this informa- 
tion will appear on the check-entry dia- 
log box, simulating the appearance of an 
actual check) and the starting balance for 
your account. Note that you don't have 
to enter a full nine-digit zip code; the pro- 
gram will be perfectly happy with only 
the first five digits. You can move between 
the dialog box's various fields using the 
up and down arrows on the keyboard. 
(The Tab key will move you forward one 
field.) When you've entered all the infor- 
mation properly, click on the OK button 
to proceed. At any time, you may click on 
the CANCEL button to discontinue the 
creation of a new account. 

When you click on the OK button, an- 
other dialog box will appear, asking for 
the account's base filename. The program 
will use this filename as the starting point 
for creating all the files needed for your 
account. For example, I might want to 
name my account WALNUM. When I 
enter this filename, MkroCheck ST will cre- 
ate a file for each month, named WAL- 
NUM 1. DAT, WALNUM2.DAT WALNUM3. 
DAT, etc. The program will also create a 
file named WALNUM.MCK, which will 



contain the information that I entered 
in the new-account dialog box. 

Enter your account's base filename 
(you're limited to six characters), and then 
click on the OK button to finalize your 
entry. If you wish to discontinue the new- 
account process, click on the CANCEL 
button. 

When you click the OK button, the pro- 
gi am will create your on-disk account. Af- 
ter this process is completed, the program 
will display yet another dialog box, 
prompting you for the month you wish 
to open. (See Figure 3.) Select the month 
by clicking on the appropriate button and 
then on OK. 

Because your newly created account 
contains no data, an alert box will appear 
informing you that the current month file 
is empty. Click on the YES button if you 
want to start entering transactions into 
your new account. Click on the NO but- 
ton to leave the new account as it is. 

If you have been using the 8-bit version 
of MicroCheck (published in the February 
and March 1985 issues of ANALOG Com- 
puting), it is possible to port the data for 
your account over to the ST version. For 
information on how to do this, see the 
section titled "Porting 8-bit files." 



Opening an account 

The account creation process described 
above need only be done once for each 
account that you wish to use However, ev- 
ery time you run MkroCheck ST, you must 
open the account that you want to work on. 

To open an account, click on the Open 
selection of the File menu or press Control- 
O. A GEM file selector will appear. Double- 
click on the .MCK file for the account you 
wish to open, and you will then be present- 
ed with the month-selection dialog box. 
Click on the appropriate button; then click 
on OK to continue — or CANCEL to abort 
the Open function. 

If the month you open contains no data, 
you will be asked if you wish to start a new 
month. Click on the YES button to open 
the month. If you click on YES, the 
new month will be opened, and any au- 
tomatic transactions you have in your 
.AUT file will be added to the new month's 
data. (See the section titled "Automatic 
transactions" for more information.) 

When a account is first opened, 
MkroCheck ST is in the edit mode as indi- 
cated in the window's title bar. (See 
Figure 4.) In the edit mode you may enter 
new transactions or modify previously 
entered transactions. 
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Enter your account's 
base filename (you're 
limited to six characters), 
and then click on the OK 
button to finalize your 
entry. When you click on 
the OK button, the 
program will create your 
on-disk account. After this 
process is completed, the 
program will display yet 
another dialog box, 
prompting you for the 
month you wish to open. 
Select the month by 
clicking on the 
appropriate button and 
then on OK. 



Entering checks 

Once you have an account opened, you'll 
want to begin entering checks. To do this, 
click on the Enter entry of the Checks 
menu or press Control-E. The check-entry 
form will appear. (See Figure 5.) 

The check-entry form contains fields for 
all of your check's data, plus three buttons 
across the bottom. You can move between 
the check fields by using the up and down 
arrow keys. The tab key will also work, mov- 
ing the cursor forward one field at a time. 
To jump quickly to a specific field, click 
on the field with the mouse. 

The check number is, of course, the 
number of your check. This field will au- 
tomatically advance by one each time you 
enter a check; so if you're processing your 
checks in order, you won't have to type any- 
thing in this field after the first check has 
been recorded. Note, however, that there 
are two reserved check numbers that you 
may not use for your normal checks: 0000 
and 9999. 

You should use a check number of 0000 
for any transaction (other than a deposit) 
that was performed without a written 
check. For example, you might withdraw 
money from your checking account using 
an ATM (automatic teller machine). Even 



though you haven't actually written a check, 
you must nonetheless record this trans- 
action. 

The check number 9999 is reserved for 
deposits. Any time a transaction credits 
your account, this check number signals 
MicroCheck ST to add the amount of the 
transaction to your balance rather than 
subtracting it. Don't enter anything in the 
Payee field of a deposit (it won't hurt any- 
thing if you do, but you'll be wasting your 
time). MicroCheck ST automatically places 
the word "DEPOSIT" in this field when 
the checks are displayed in the check win- 
dow. (Nothing will appear in the check- 
entry dialog box's payee field when you 
first enter the check.) If the credit comes 
from something other than an actual 
deposit (for instance, an interest payment), 
use the Memo field to note it. 

When all of the information for a 
check has been entered, you must click 
one of the buttons along the bottom of 
the check form— or simply press Return 
to enter the current check and set up the 
form for the next. Clicking on the NEXT 
button has the same effect as pressing 
Return. Clicking on the DONE button 
enters the current check, then closes the 
check-entry form. Clicking on CANCEL 



closes the check-entry form without en- 
tering the current check. 

Editing a check 

If you find that you must edit a previ- 
ously entered check, use the mouse to click 
on the check's entry in the window, and 
the check-edit form will appear. This form 
looks almost identical to the check-entry 
form. The only difference is that the NEXT 
button is no longer functional, and the 
DONE button is now the default (the but- 
ton that will be selected if you press 
Return). When the form appears, make 
whatever changes you wish to the check's 
data, and then press Return or click on 
the form's DONE button. If you click on 
the CANCEL button, the check entry will 
remain unchanged, even if you changed 
some of the fields in the check-edit form. 

If you make any changes to the amount 
of the check, your balance will, of course, 
be updated to reflect those changes. 

Searching checks 

If you need to locate a check or group 
of checks, you can use MicroCheck STs 
search feature To access this function, click 
on the "Search" option of the Checks drop- 
down menu or press Control-S. The search 
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When an account is first 
opened, MicroCheck ST is 
in the edit mode as 
indicated in the window's 
title bar. In the edit mode 
you may enter transactions 
or modify transactions that 
have been previously 
entered. 
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parameter-entry form will then appear. 
(See Figure 6.) When the form appears, 
each of the search parameter fields will 
contain default values. If you were to use 
all of the default values, you would be 
searching for every check in your account. 

Fill in the parameters for the search, us- 
ing the arrow keys. Tab key or mouse to 
move between the form's various fields. 
When you've filled in your search 
parameters, press Return to begin the 
search, or click on the OK button. 

During a search, the parameters you en- 
tered are compared to the data found in 
each entry of your account. If the trans- 
action matches every criterion in the 
search, it is added to the check list. Note 
that both of the text fields in the search 
parameters. Payee and Memo, will allow 
partial matches— that is, a payee search 
parameter of la will match checks with 
such payees as Tammy Brooks, Tabitha 
White and Tadbury Lumber To find every 
check with a payee field beginning with 
Q just enter G as the payee parameter Also 
note that the search function is not case- 
sensitive. To MicroCheck ST the letter "G" 
and the letter "g" are the same value. 

A search is limited to a check list of no 
more than 1,000 entries. If the number of 



matches exceeds this (highly unlikely), an 
alert box will appear, informing you the 
search window will hold no more checks. 

When the search is complete, a dialog 
box will appear showing the totals for the 
search. Click on the OK button or press 
Return to remove this dialog box, and the 
checks that matched your search criteri- 
on will appear in the check window. You 
are now in MicroCheck STs search mode, 
in which you may not edit or enter trans- 
actions. To exit the search mode and return 
to the edit mode, click on the Close en- 
try of the File drop-down menu, press 
Control-C on your keyboard, or click on 
the window's "close box," located in the 
upper left corner of the window 

Selecting a new month 

Many times when entering transactions, 
you may have to move from one month 
to another To close the current month and 
move to another, click on the New Month 
entry of the File menu or press Control- 
M. The new-month dialog box will then 
appear. To select a new month, click on 
the appropriate month button and then 
click on OK. To exit the dialog box without 
selecting a new month, click on the CAN- 
CEL button. 



Printing check data 

MicroCheck S7" provides two methods of 
creating hard copies of your checking ac- 
count. In the Print drop-down menu, you 
will find the selections Window and 
Register The former is used to print only 
those checks in the current window; the 
latter prints the entire account. Click on 
the appropriate menu selection, or press 
Control-W or Control-G, respectively. 

Cancelling checks 

When you receive your statement from 
the bank each month, you must go through 
your account and mark those transactions 
that the bank has processed. This is the 
first step in "reconciling" your account, 
a process that ensures that your figures 
match those of the bank. 

To enter MicroCheck STs cancel mode, 
click on the Cancel entry of the Checks 
drop down window or press Control-P on 
your keyboard. A dialog box similar to the 
one shown for selecting a new month will 
appear. Click on the month you want to 
work on, and then select the OK button; 
the mode displayed in the window's title 
bar will then change from edit to cancel. 

In the cancel mode, whenever you click 
on a check displayed in the window, in- 
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Once you have an account 
opened, you'll want to 
begin entering checks. To 
do this, click on the Enter 
entry of the Checks menu 
or press Control-E. The 
check-entry form will 
appear. 



Stead of bringing up the check-edit form, 
MkroCheck ST will place an asterisk next 
to the entry, indicating that the bank has 
processed that transaction. To uncancel 
an entry, click on it a second time. The 
asterisk will be removed. 

When you're finished cancelling trans- 
actions, return to the edit mode by click- 
ing on the Close selection of the File 
menu, press Control-C, or by clicking on 
the window's close box. 

Reconciling your account 

Once you've gone through your state- 
ment and cancelled all the appropriate 
transactions, you may reconcile your ac- 
count. Click on the Reconcile entry of the 
Checks drop-down menu or press Con- 
trol-R on your keyboard. A dialog box will 
appear, requesting your account's ending 
balance as shown on your bank statement. 
Once you've entered this amount, press 
Return, and MkroCheck ST will read 
through all your check files and, after mak- 
ing the appropriate calculations, display 
a final report. (See Figure 7.) If the amount 
shown at the bottom of this report is 0, 
then your figures agree with the bank's. 
Otherwise, either you or your bank made 
a mistake. 



Press Return to exit from the reconcile- 
report dialog box. 

Adjusting your balance 

Sometimes, no matter how hard you try, 
you simply cannot get your account to 
agree with your bank statement. Usually 
this means that you've made a mistake 
somewhere in your account — maybe a 
check is made out for a different amount 
than what you recorded — that you have 
not been able to find. Although you should 
always try to reconcile your account proper- 
ly there may be times when you have to 
give up. In those cases, the best you can 
do is adjust your account's balance to agree 
with the one on your statement. 

To perform this adjustment, enter a 
dummy check or deposit transaction for 
an amount that will bring your balance 
to the proper amount. When entering a 
dummy check, use the number 0000. These 
dummy transactions should be cancelled, 
just as if they had appeared on your 
statement. 

Automatic transactions 

Many banks can, at your request, set up 
your checking account so that it will au- 
tomatically pay out checks at specified 



times each month. This type of service 
works out well for all the parties involved. 
It's convenient for you not to have to 
remember to write a check every month, 
and the payee (maybe an insurance com- 
pany or a telecommunications service) can 
be reasonably sure it will get its payment 
regularly and on time. 

Of course, if your checking files are go- 
ing to be accurate, these transactions need 
to be entered into files just like any other 
Fortunately MkroCheck ST provides you 
with a method of handling automatic trans- 
actions, both debits and credits. You need 
enter this type of transaction only once, 
into a special file, after which time it will 
automatically be added to your account's 
data every time you start a new month. 

To set up an automatic transaction, click 
on the Auto selection of the Checks drop- 
down menu or press Control-A. The check- 
entry form will appear with the memo field 
already filled in as AUTO. Simply fill out 
the check data as normal. When the form 
has been completed, and you press the OK 
button, the check will be added to your 
auto file (the file with the .AUT extension). 
Every time you open a new month (one 
whose file contains no check data), the 
transactions in the .AUT file will be au- 
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If you need to locate a 
check or group of checks, 
you can use Microcheck 
ST's search feature. To 
access this function, click 
on the Search option of 
the Checks drop-down 
menu or press Control-S. 
The search parameter- 
entry form will appear. 
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tomatically added to that month's data. 

If you've never entered an automatic 
transaction into your account, there won't 
be an .AUT file on your disk. When you 
attempt to add your first AUTO check to 
the account, you'll be asked if you want 
to start a new AUTO file. Click on the YES 
button, and the file will be created for you. 

If you ever want to discontinue the use 
of the automatic transactions, simply de- 
lete the .AUT file from your data disk. 

Closing your account 

When you're ready to conclude a check- 
ing session, it's important that you close 
your account. Failure to dose your account 
properly may result in lost check data! 

To close your account, click on the Close 
entry of the File drop-down menu, press 
Control C or click on the window's close 
button. You may close your account only 
when in the edit mode. 

Quitting 

You may return to the GEM desktop by 
selecting the Quit entry of the File drop- 
down menu or by pressing Control-Q The 
Quit selection is a safe way of closing your 
account. All your data files will be properly 
updated before the program terminates. 



Starting a new year 

MiaoCfwck 57^s calendar runs from Janu- 
ary to December. That means that, come 
January 1, you must clear out the old files 
and start anew. Before you do this make sure 
you have bached up your MicroCheck ST data 
disk' If you fail to do this, you will have 
no way to refer to the previous year's files. 

Before you can set up a new year, you 
must close the account you have open (if 
any). Then click on the New Year entry 
of the Utilities drop-down menu or press 
Control-Y. You will be asked if you really 
want to create a new year. If you click on 
the YES button, you will be asked again, 
just to make sure— remember, this func- 
tion will destroy existing MicroCheck ST files 
on your data disk. Finally, a file-selector 
box will appear. Click on the .MCK file 
for the account you wish to set up for the 
new year. 

MicroCheck ST will go through your en- 
tire account, deleting all cancelled trans- 
actions and moving uncancelled 
transactions into a special file for Month 
0. The Month 0 file can be manipulated 
just like any other month's file and is simply 
a place where unprocessed transactions 
from the previous year can be stored un- 
til your bank statement shows that they 



have been processed. When you get your 
bank statement, you should go through 
Month 0, cancelling checks the same way 
you would for any other month. 

When the New Year process has been 
completed, your account will contain check 
data only in Month 0 (and only then if 
you had uncancelled transactions in your 
account, which is likely); all other months 
will be cleared. (You made that back-up, 
right?) Automafic transactions, however, are 
unaffected by the New Year process and 
will still function properly with the new 
year's files. 

Porting 8-bit MicroCheck files 

For those of you who have been using 
the 8-bit version of MicroCheck, the ST ver- 
sion provides a function that will convert 
the old checking files for use with this 
program. 

The first step in this process is to move 
the files from the 5 'X -inch disk to a 
3 '/z -inch disk. There are two ways to do 
this. The first method requires a "null- 
modem" cable A null-modem cable allows 
two computers running telecommunica- 
tions programs to directly transfer files be- 
tween them and may be purchased at most 
Atari computer dealers. To use the cable. 
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Click on the Reconcile 
entry of the Checks drop- 
down menu or press 
Control-R on your 
keyboard. A dialog box 
will appear, requesting 
your account^s ending 
balance as shown on your 
bank statement. Once 
you've entered this 
amount, press Return, and 
MicroCheck ST will read 
through all your check 
files and, after making the 
appropriate calculations, 
display a final report. 



connect one end to your ST's modem 
and the other end to your 8 bit com- 
puter's modem. Then run a telecommu- 
nications program on each computer. Set 
your ST to receive X-Modem, then do an 
X-Modem send of all the MicroCheck 
monthly files from your 8-bit computer. 

Another way to do the transfer is to use 
your 8-bit computer to upload the 
MicroCheck data files to a BBS system or 
into your workspace on a commercial 
online system such as DELPHI, GEnie or 
CompuServe, and then download your 
files onto your ST. (If you use a BBS for 
this transfer, you'll need to make special 
arrangements with the SYSOPs. You 
don't want to find all your checking files 
in a public download area!) 

Whichever method you use, make sure 
that you make the X-Modem transfer in 
the binary mode rather than in the text 
mode. And note that the only files that 
you need to transfer are the monthly 
data files. On your 5 K -inch disk, these 
files are named MONTH00.DAT, 
MONTHOl.DAX MONTH02.DAT, and so 
on. Further, note that empty months 
need not be transferred. When you run 
MicroCheck STs Import function, it'll cre- 
ate new month files for any 8-bit data 



files that are missing. 

Once you have the files transferred, 
place them in the same directory as the 
MicroCheck ST program, and then run 
MicroCheck ST. Create a new account as 
described in the section "Starting a new 
account" above. For the account's 
balance you should use the balance 
shown in your 8-bit MicroCheck account. 
When the new account is ready, click on 
the "Import" selection of the Utilities 
drop-down menu. An alert box will ap- 
pear, asking if your 8 bit MicroCheck files 
are in the same directory as the 
MicroCheck ST program. If you're ready 
to continue, click on the YES button or 
press Return. A file-selector box will then 
appear. Select the .MCK file for the new 
account you just created, and MicroCheck 
Srwill then transfer your 8-bit checking 
data into that account. 

If you had any automatic transactions 
in your 8-bit account, you will need to re- 
enter them using the method described 
in the section "Automatic transactions" 
above. 

Conclusion 

This program has been in the works — 
off and on — for over two years, and I 



have to admit that it is with great relief 
that I release it to the pages of ST-LOG. 
Although I suppose it's too much to hope 
that MicroCheck ST will be as popular as 
its predecessor was (according to some 
unwritten law of the universe, an author 
usually is allowed only one mega-hit per 
lifetime), I'm confident that you will find 
it a useful addition to your applications 
software library Use it in good health— 
and may your account always balance. 



CLAYTON WALNUM 



•• The author 
would like to 
thank Jim Gross 
for his relentless 
efforts in beta- 
testing this pro- 
gram and for his 
helpful sugges- 
tions. Jim's uncan- 
ny ability to crash 
even the most 
solid of programs 
has made this the 
best it can be. 
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LOW RESOLUTIOM 



Animated 
GFA Input 



In the movie Short Circuit, we hear the 
robot. No. 5, frantically calling for more 
input, a word very important to us 
programmers because the user has to 
have some way of communicating with 
the machine. No. 5 was able to communi- 
cate through voice input, along with a 
myriad of sensory inputs (sophisticated, 
indeed), but our home computers are still 
a long way from behaving in this manner, 
so we input mainly through the keyboard. 

I'm not knocking the mouse, mind you, 
because I think it is a fast way of com- 
municating with the machine on a sym- 
bolic level— click on the icon, and presto! 
You get a reaction. But when it comes to 
entering long strings of text into our 
home computers, the keyboard is still the 
most expedient peripheral. 

I program most of my games for the 
Atari ST in GFA BASIC because its inter- 
preter is easy to use and the source code 
can be compiled to a very fast .PRG file. 
GFA has a good selection of input rou- 
tines, but I found that there was some- 
thing else I needed. The built-in input 
procedures of GFA work in one of the fol- 
lowing ways: either you enter a complete 
string or a single character While you 
enter the string, all other activity of the 
program freezes. Hit Return and the pro- 
gram resumes its activities — useful, but 
boring, especially for the game 
programmer. 

Single-character input can allow screen 
activity to continue but restricts the 
amount of input allowed. The program 
can be made to check for a certain key 
press, but once that key is pressed the pro- 
gram is back about its business. One 
character is not usually enough, unless 
you're working off a menu. 

Suppose you want to enter a string of 
characters — a person's name, a guess at a 
question, an item for a list— and still want 
some activity on the screen simul- 
taneously — some sort of animation, for 



BY ALBERT BAGGETTA 

example. It is possible and not very 
difficult to accomplish if you do some 
planning and use some imagination. 

I was confronted with just such a dilem- 
ma while writing a game program recent- 
ly I wanted the user to be able to enter 
a response to a question, but at the same 
time I wanted a pulsating border around 
the input area. The accompanying rou- 
tines show some of the code I used to ac- 
complish this, and it can easily be adapted 
for other uses. 

Listing 1 is a low resolution, demon- 
stration GFA program I have written to 
show how you may enter some short in- 
put (as described above) while screen ac- 
tivity continues. When you run the 
program, you will see a border of aster- 
isks surrounding the prompt "Enter Your 
Name:" Type your name (no more than 
15 characters are allowed here), and then 
press Return to have the name string 
printed below the border. You will notice 
that while you are typing your name, the 
border animation continues without in- 
terruption. 

If you study Listing 1, you will see that 
the first part of the program creates the 
animated sequence while the computer 
checks for the string value entered into 
X$. The InkeyS routine of GFA is used for 
this fast check. The source code section 
marked INPUT EXAMINATION is used to 
handle the input. First we check to see if 
the key pressed is "legal" before we show 
its character on the screen. (Everything is 
legal at this point except the Return key 
and the Backspace key These will not 
print; they will result in an action. All 
other keys will be accepted and printed 
on the screen.) 

One of the problems I had with this 
routine was allowing the correction of er- 
rors. Out of frustration, I resorted to the 
easiest method: instead of using Back- 
space to correct one character at a time, 
I have it erase the entire line, making the 



user start over again. This is not the best 
way to handle the editing, but since the 
required input is short, no great burden 
is placed on the user. 

The whole input sequence and anima- 
tion is placed within a REPEAT/UNTIL 
loop. When becomes equal to a 
Return, or you have used up the allotted 
15 characters, the routine ends, and your 
string is printed. In an actual program, 
you might print the resulting string, but 
more likely the string (called Name$, here) 
will be used to check for a correct answer 
or possibly might be used as part of a list. 

The animation I created was done with 
the normal ASCII characters, but any 
kind of graphic or character animation 
can be incorporated in the loop. Because 
of GFA's tremendous speed, it takes quite 
a bit of screen acfivity before any hesita- 
tion appears in the actual input or ani- 
mation. 

I have put a delay loop at the end of 
the program, which is used during anima- 
tion to slow down the speed of the flash- 
ing asterisk. If you play with the value in 
the delay loop, you can see how the move- 
ment is affected on screen. 

Feel free to use this routine and modi- 
fy it any way necessary. And let's see more 
animated input in the GFA programs you 
produce. 




Albert Ba^ettu is an English teacher and 
a professional guitarist. He lives in Agawam, 
Massachusetts, with his wife, Beverly, and his 
two children. He frequently can be found wan- 
dering the STLOG SIG on DELPHI. 



Listing 1 : 
GFA BASIC 2.0 



* * 

* Aninated Input GFA « 

* by Albert Baggetta « 

* » 

» Copyright 1989 by ST-LOG n 

Set screen colors 

Setcolor 0,3,4/5 
Setcolor 15,7,7,7 

I Set the starting points for aninated box 

Cd_right>t=5 
Rd_downX=5 
C>;=10 
Ry.=LQ 

I 

' Draw box of asterisks 
I 

Print AttCd-rightx, Rd-downxi ; " "xxxxxxxxxxxxxxxxxxxxxxxxxxx " 
For Ln_rowX=b To 15 

Print AtCCd-rightX, Ln_rowX) ;"» 
Next Ln_rowx 

Print AtCCd-rightX, 15) ; " xxxxxxxxxxxxxxxxxxxxxxxxxxx " 
Print Attn, 7) ; "Enter Vour Hane:" 

I Begin the nain loop for anination and input 

Repeat 

X$=Inkey$ 

I 

I Move the asterisk to the right on screen 

Rd_down>;=5 And Cd_rightx<32 Then 
Inc Cd_right>; 

Print At(Cd_rightx, Rd.down^;) 
GDel_ay 

Print AttCd-rightX, Rd_downxJ ;" " 
GDel_ay 

Print AttCd-rightx, Rd.dounK) 

GDeI_ay 

Endif 
I 

' Move the asterisk down on screen 

"t''*^!,'!! 5"** Cd_rightX=32 And Rd_doMnx<15 Then 
Inc Rd_downK 

Print At tCd_rightx, Rd_down>;) 
ODel_ay 

Print AttCd-rightx, Rd_down>c) ;■' " 
GDel_ay 

Print At(Cd_rightx, Rd_downx) ;"»■' 
GDel.ay 
Endif 

I 

I Move the asterisk to the left on screen 

If X$="" And Rd_downX=15 And Cd_ri9ht>;>5 Then 
Dec Cd_rightx 

Print At(Cd_rightx, Rd-downX) 
GDel-ay 

Print At(Cd_rightx, Rd-downx) ;" " 
GDel.ay 

Print At(Cd_rightX, Rd-dounx) ; 

GDel_ay 

Endif 
I 

I Move the asterisk up on screen 

If X$="" And Cd_right>C=5 And Rd_downX>5 Then 
Dec Rd_down»: 

Print AttCd-rightX, Rd.downXJ ; 
GDel.ay 

Print AtCCd-rightX, Rd-downx) ;" " 
GDel-ay 

Print AtfCd_right>:, Rd.downX) 
GDeI_ay 
Endif 
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ANIMATED INPUT 



INPUT EXAMINATION 



■ If a legal key is pressed, print it. 

If XSO"" And XSOChrSlSl Then 

Print AttCX.RX) JX$ 
Nane$=Nane$«X$ 
Endif 

I 

' If the <backspace> keg is pressed, erase the string so far 

I 

If XS=ChrSt8) Then 
For Ers=18 To CX 

Print AttErs,RX);" " 
Next Ers 

NaneSz'"' 
Endif 

I 

• If the <return> or the nax length of string, junp out of loop 

I 

Until XS=ChrStl3) Or Cx=25 ! Max happens to be 15 characters here. 

■ 

■ Print the string — here it is called NaneS. 

■ 

Print AtCll, 18) ;HaneS 

Print At C13, 26); "Press A Keg" 

■ Hold on screen for this deno until a keg is pressed 



Until InkegSO"" 
Setcolor 6,7,7,7 
Setcolor 15,6,8,6 

I 

■ A delag loop to keep the asterisks fron noving too fast. 
' Make this a snaller nunber and watch the speed. 

I 

Procedure Del_ag 

For DX=i To 168 

Next [>y. 
Return 

Attention 
Programmers! 

ST-LOG Magazine is interested in programs, articles, and software review sub- 
missions dealing with the Atari home computers. If you feel that you can write as well 
as you can program, then submit those articles and reviews that have been floating 
around in your head, awaiting publication. This is your opportunity to share your know- 
ledge with the growing family of Atari computer owners. 

All submissions for publication, both program listings and text, should be provided 
in printed and magnetic form. Typed or printed copy of text is mandatory and should 
be in upper and lowercase with double spacing. By submitting articles to ST-LOG 
Magazine, authors acknowledge that such materials, upon acceptance for publica- 
tion, become the exclusive property of ST-LOG Magazine. If not accepted for pub- 
lication, the articles and/or programs will remain the property of the author If submissions 
are to be returned, please supply a self-addressed, stamped envelope. All submissions 
of any kind must be accompanied by the author's full address and telephone number. 

Send your programs and articles to: 
ST-LOG Magazine 
P.O. Box 1413-M.O. 
Manchester, CT 06040-1413 
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micrQtyme 



A DIVISION OF MICRO PERIPHERALS, INC. 
MARSHALL PD. • KETTERING, OHIO ^5423 



OiXOVtR 



A 

ATARI 



HARDWARE 
ST'S. . .IN STOCK!!! 

Color Monitors CALL 

Mono Monitors CALL 

SF 314 Drive . . . CALL 

GTS 100 Drive , CALL 

IB 5'/. Drive , , , 199 

Uavatone Scanners CALL 



MODEMS 

SX-212 300/1200 bps CALL 

Avatex 1200E 79 

Zoom 2400 125 



PRINTER'S DEVIL 
HI-RES GDOS 
FONT & CLIP 
ART PACKS 
IN STOCK! 
(Great for 
Desktop Publistiingl!) 



ATARI ST 
SCANNERS, 

SOUND & 

VIDEO 
DIGITIZERS 

In Stock! 



SUPRA 2400 

HAYES® COMPATIBLE 

«124.95 

6' ST MODEM CABLE 9 

(With Purchase Of Supra) 



HARD DISK DRIVES FOR ST'S 



★ ST SOFTWARE ★ 



lOtn Frame 8ow(mg 


26 


Cracked 


21 


220 ST (Terminal Emulator 


15 


Crazy Cars 


25 


30 Breakthru 


26 


Cyber Control 


39 


AB Zoo 


21 


Cyber Paint 


- 48 


AOvanced OCPArt Studio 


. 31 


Cyber VCR 


45 


Air Ball 


, 26 


Dark Castle 


-. 27 


Air Ball Construction Set 


17 


Data Manager ST 


46 


Algeora I, 2. 3 


ea 14 


Dalatrieve 


33 


Ahants 


19 


OB Man 


149 


All ADout America 


41 


Deatn Sword , 


13 


All 


21 


Deep Space 


31 


Alternate Reality-The City 


32 


Detender of tne Crown 


31 


Alternate Reality-Tlie Dungeon 32 


Degas Elite 


38 


America CooKs Series 


ea 9 


Demon s Winter 


25 


Arctiitectural Design 


19 


Desk Cart 


67 


Arctic Fox 


26 


Digi Drum 


14 


Art Gallery 1. 2, 3 


ea 19 


Dive Bomber , 


. 19 


Assem Pro 


37 


Or Drums IDRT) 


19 


Autoduel 


24 


Dr. Keys(DRT) 


19 


Award Maker 


27 


Dralix 


129 
18 


Balance of Power 


32 


Dungeon Master 2 


Bally Hoc , 


27 


Oyna Cadd 


429 



PRINTERS 

PANASONIC ollvMnt 

1180 CALL 

1191 tALL 

1124 CALL 
Ranasonc Brand PJb CALL 

STAR Calftjlstest 

NX-1000 NEW . CALL 
NX-IOOOCotor. CALL 
lOOORiPbon(Blk) 6 
1000 Ribbon iCdOfl 8 

OLYMPIA simply, tin best! 

NLQ nxxles use 18 x 24 matnx' 
NP-30 IX CPS 199 

NP-BOs 240 CPS cnangeaole 

font cards 349 

NP-136 15 inch 529 



SUPRA 30 MB HARD DISK 

5i 



649 



OTHERS CALL 



ICD 20 MB HARD DISK 

$1 



599 



OTHERS, INCLUDING TAPE BACK-UP . . CALL 



ST Dust Covers 


from 8 


Mouse Mai 


. 5 


Power Slnpw/ Surge 


15 


Deluxe Power Slnp w/ Surge 


24 


Dnve Master . 


32 


Monror Master 


32 


Mouse Master 


29 


EPYX 500 XJ Joystick 


15 


WICC Ergo Stick Joystick 


. 17 


Pnnter Stand-Heavy Duty 


13 


Mail Labels 3.5x15/16-500 pk 


4 


1000 Dk . 


6 


Compuserve Starter Kit , 


24 


On-Lme Encyclopedia Kit . 


. 36 


Pnnter Cable 6' 


14 


Modem Cable 6' 


14 


MIDI 




Midi Cables 5' 10 25' 


CALL 


Software iHybnd Arts etc ) 


CALL 



★ ST SOFTWARE ★ 



N Vision .... 29 
Neo Desk 2 .33 
New Tecfi Coloring Book ,15 
Night On The Town , , , ,22 

Ninja 14 

ODIilerator 25 



LARGEST SELECTION IN THE U.S. 
★ OVER 1000 TITLES IN STOCK ★ 
IF YOU SEE IT CHEAPER IN ANOTHER AD 
CALL US ANYWAY. . .WE RE PROBABLY ALREADY 
LOWER. . .THESE ADS TAKE 3 MGS. TO GET OUT 



Barbarian 25 

Bares Tale , . 31 

Base Two 45 
Basketball (Two on Two) 26 
Battle Droiflz 25 

Battlezone 19 

Beyond Zork 34 

■lology 1. 2, 3 or 4 ea 14 

Bismarck 28 

Black Lamp 17 

Blockbuster 27 

uioerdasn Construction Kit 17 

Brataccas 15 

Breacn 27 

Bridge 5.0 24 

■uDDieGfiost 24 

usiness Tools 26 

Ca0 3D(Ver 2 0) 57 

Calamus . . . . .175 

Calamus Font Editor . 62 

Captain Blood 31 

Carrier Command 29 

Ceniltcale Maker . 25 
Championsnip Baseball 27 
Cliampionsnip Wrestling 26 
Ctiartoak , 34 
Chessmaster 2000 29 
Cfirono Quest 29 
Circuit Maker 2 63 
Clip Art 1, 2. 3. 4, 5. 6 ea 13 
Club Backgammon 23 
Color Computer Eyes 169 
Colorourst 3000 . 25 
Copyist Level 2 158 
Cosmic Relief 26 



Easy Draw (Regular) 

Easy Draw W/Superctiarger 

Easy Tools 

Elite 

Empire 

Expen Opinion . . 

EZ Score Plus . 

EZ Track Plus 

F15 Strike Eagle 

Falcon ST (Low. Low) 

Fast Basic 

Fast Basic M Compiler 

Fire and Forget 

First Cadd 2.0 
First Letters & Words 
First Stiapes 

First Word Plus 

Flasn (Great!) 

Flignt Simulator 2 

Scenery Disks 

Font Disks (Pub Part) 1-6 . 

Fonts and Borders 

Fonlz ST 

Foundations Waste 

Fraction Action 

G -1- Plus 

Gateway 

Gauntlet 

Genesis (Molecular Modeler) 
GFA Basic 3.0 
GFA Basic Book . 

GFA Companion 

GFA Compiler . 

GFA Drafi Plus 

GFA Quick Reference Manual 



63 
95 
32 
22 
34 
72 
95 
43 
24 

CALL 
59 
. 19 
25 
33 
25 
25 
59 
18 
32 

ea 18 

ea 20 
24 
22 
.26 

. 24 
21 
31 

. 31 
59 
59 
27 
32 

. .38 
.49 

. .12 



GFA Ray Trace 59 

Gladiator . 25 

Global Commander 28 
Gold Of The Realm 24 

Gold Rusn 25 

Goidrunner 26 

GolOrunner 2 27 

Goidrunner 2 Scenery Disks ea 7 
GoneFisnm' 28 
GreatChels Vol 1. 2, 4 3Sel 39 
Gridiron (Football) 19 
Gunship 26 
Hard Disk Backup .. ,23 
Harrier Combat Simulator . 34 
Heroes 01 The Lance . .26 
Hi Soft Basic Pro .109 
High Roller , 27 

Hollywood Hijinx 19 
Human Design Disk 19 

Hunt lor fled October 32 

IB Copy . . .23 

Impossible Mission 2 . 27 
Indiana Jones Temple of Doom 31 
nterlinkST 24 
International Soccer 25 
'nlo The Eagles Nest 24 
Inventory Manager 52 

Jet 33 

Jinxter 27 
Joust ... 18 
Juggler , (New Version! .32 

Karate Kid 2 27 

Karateka 23 

KCSLevel2 189 

Kid Progs 27 



Kinderama 24 
kings Quest 1. 2. 3 or 4 . ea31 
Knickerbockers 12 
LOW Power Spreadsheet 89 
Label Master Elite 26 
Lattice C 109 
Leaoerboard Dual Pack 15 
Leatherneck 25 
Leisure Suit Larry 1 or 2 24 
Lock On 24 
Lords of Conquest 13 
Lords ol the Rising Sun . 31 
Macro Mouse 25 
Magic Sac Plus 89 
Magic Sac Roms CALL 

Ma|or Motion 25 

Warble Madness 27 

Mark Williams C 114 

CSD Source Debug 39 

Master Cad 119 

Match Point 25 

Mavis Beacon Teaches Typing 32 
MegamaxC (Laser C) . 118 

Mercenary 27 

Metro Cross 16 
Micro Kitchen Companion 26 
Microieague Baseball 36 
Microsoft Write .65 

Midi Draw 63 

Midi Maze 26 
Midi Recording Sludio [OR T) 36 
Missile Command . 18 
Mixed Up Moiner Goose 2i 

Muiti Desk 19 

Music Studio 88 .34 



Ogre 

Olds 

Omnires . 
arbiter 

Page Stream 

Paint Prn 

Paintworks 

Paperboy 
Partner Fonts 
Partner ST 

PC Ditto 2 Low 
Perfect Match 
Personal Pascal 
Phantassie 1. 2 or 3 
Phasar3.0 
Pinball Wizard 
Pirates of the BarPary Coast 

Planetarium 

Platoon 

Police Quest 1, 2 
Pool of Radiance 
Prime Time 
Print Master Plus 

Prison 

ProCopy. (LatestVer.) 
Publisher ST 
QBall 

Quantum Paint Box 

Quink 

Raslan 

Read & Rhyme 24 

Renegade (Outcast) 14 

Road Runner 26 

floadwars 22 

Rockford 22 

Santa Paravia 19 

Scan Art 32 
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SDI ; 13 

Shadow 18 
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Shard of Spring . . 27 
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Silent Service 24 
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Spiderman 7 
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Sundog 
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Tune Smith lOR T) 95 
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Turbo ST 32 
TV Spons Football 31 
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Universal Military Sim 31 
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Vegas Craps 24 
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WWF Microieague Wrestling 
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Zak McKracken 
Zany Golf 
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'raphics. These days it's next to impos- 
sible to work with a computer and not see 
them. Databases store pictures along with 
other data, word processors integrate text 
and graphics, and desktop publishing 
software goes even further. Heck, even the 
letters on your ST's screen are bit mapped 
graphics, not a dedicated text-only video 
output. And if you play games or use a 
drawing program, graphics are even more 
unavoidable. 

The graphics capabilities of personal 
computers have grown by leaps and 
bounds in the industry's brief 12 years of 
existence. Ever look at the "high res" 
graphics of an old Apple II? An incredi- 
ble 280 X 192 pixels (a pixel is one com- 
puter generated dot on the screen) using 
eight colors! Actually, it took two of those 
horizontal dots to make one colored pix- 
el. There were eight colors, but separat- 
ed into two distinct, four-color palettes 
that were incompatible with one another, 
meaning you couldn't put a color from 
Palette 1 alongside a color from Palette 
2 without color bleeding — unless the junc- 
tion between those pixels fell exactly on 
a byte boundary! To further complicate 
this mess, each palette contained a black 
and a white color — so you actually got six 
colors, not eight! 

The Atari 8-bits expanded this some- 
what, adding numerous "modes" of 
different sized pixels with varying num- 
bers of colors. Palettes ranged from a to- 
tal possible 128 colors on early machines 
(eight luminances of 16 colors) to 256 
colors (16 luminances of 16 colors). 
Although the normal modes limited the 
number of colors that could be used on 
a given screen (usually to four, although 
some GTIA modes allowed 16), with spe- 
cial programming every color in the 
palette could be viewed on a single 
picture. 

In more recent years things have got- 
ten better. The low resolution mode of the 
ST has more pixels on the screen than the 
highest resolution on the Atari 8-bit com- 
puters, a range of 512 possible colors, and 
normally allows 16 colors at once (and 
with special programming it's possible to 
put all 512 colors on screen at the same 
time). Medium resolution goes to 640 x 
200 and four colors, and high resolution 
is 640x400 in pure black and white 
monochrome. Quite a jump from the Ap- 
ple II! New monitors and graphics hard- 
ware soon promise modes upward of 
1000 X 900 pixels on upcoming Atari 
machines. 





BY MAURICE MOLYNEAUX 



So, as the hardware gets more power- 
ful, the displays get better and better. 
Compare a Spectrum 512 picture on the 
ST to even the best screen on an 8-bit 
Atari. Quite a difference. This upward 
spiral in graphics capability allows images 
created on a computer to become ever 
more realistic More colors allow more nu- 
ances in detail and shading. Higher reso- 
lution means less noticeable pixels, 
making the picture look less "com- 
puterized." 

In fact, the whole trend in computer 
graphics increasingly has been to "make 
it look real." This month the topic of Step 
1 will be hardware, software and graph- 
ics techniques that can make the ST's 
video output look its best. 

Hues there? 

Higher resolution makes smaller de- 
tails possible, but what can you do when 
you've hit the limits of your hardware? 
The 320 x 200 pixel resolution and 16 
colors out of 512 in ST low resolution are 
wonderful when compared to the graph- 
ics of the older computers described earli- 
er, but then again those low-resolution 
graphics aren't so hot when compared to 
the output of most graphics workstations. 
Computer paint-box systems for video 
purposes (TV logos, commercials and so 
on) average about 712 x 480 pixels, with 
256 colors out of a palette of 16 million! 
You don't see "jaggies" (the stair step ef- 
fect of pixels most clearly seen in di- 
agonal lines drawn by a computer) on a 
TV commercial. 

But resolution and total numbers of 
colors aren't the whole story I've seen pic- 
tures on the ST that you wouldn't think 
were only 320 x 200 pixels. One great fac- 
tor in computer graphics is how well you 
can disguise the weaknesses of your 
display. 



Making 
Mixed 
Mirages 
Woric 



Do you ever watch MTV? One of the 
regular spots that appear at commercial 
breaks is a series of short computer ani- 
mations tided "Animals." Clean, impres- 
sive graphics (and funny, too, though 
that's not relevant here). I videotaped a 
lot of these, and one, titled "That Was a 
Wolfs Life," ended with a lightning bolt 
zapping the wolf/camera (it's always from 
the point of view of the title animal). I was 
curious about how the flashing effect was 
achieved, so I studied the lightning frame 
by frame. The effect was a simple white 
on black drawing (alternated with black 
on white every third frame or so to cre- 
ate a strobing pulse). But with the image 
so reduced down to two colors I was sur- 
prised by how clearly 1 could see the jag- 
gies. The resolution isn't all that high. It's 
just that the large range of colors is used 
to blur the hard edges. 

You can see this done on personal com- 
puters all the time these days (though not 
always as often as it could and should be), 
through a technique called "anti-aliasing." 
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This means, in short, to plug a pixel of 
a medium tone between two strongly con- 
trasting colors. If you drew a dark red tri- 
angle on a bright blue background, the 
jaggies would stick out like, well, like jag- 
gies. However, if at each obvious jaggie 
you inserted a pixel of a medium purple 
color, it would soften the junction and 
make the stair-step effect less obvious. 

This can work well with as few as 16 
colors if you choose your palette careful- 
ly The trouble is manually doing this type 
of work is a real headache. There is some 
software that can help. Tom Hudson 
wrote an antialiaser desk accessory (avail- 
able from Tom himself), which will work 
on screens in DEGAS Elite or CAD-3D 2.0. 
Cyber Paint also features its own antialias- 
er function, as does Spectrum 512. 

To really get good output, though, you 
need more colors. A few programs pro- 
vide this: Spectrum 512 and Quantum Paint 
both boost the total number of available 
colors (Spectrum to the full 512 colore that 
the ST hardware can generate and Qium- 
turn Paint to a pseudo-4096— this done 
through pixel interlacing, meaning rapid- 
ly switching a pixel between one shade 
and another to create an effect of a hue 
in between.) With such programs it is rela- 
tively simple to kill the jaggies. 

Getting better images onto your ST can 
also mean culling them from outside 
sources. One such source can be another 
make or model of computer With the 
proper software a number of different 
graphics formats can be imported (and 
also exported). For example, DEGAS Elite 
can load Atari 8-bit "Koala" pictures 
(Graphics 714 mode) and Amiga IFF pic- 
ture files and then save them in DEGAS 
format. 

The shareware Pic Switch 0.7 by John 
Brochu can convert not only those for- 
mats, but also Atari 8-bit Micropainter and 
Graphics 8 and 9, MacPaint, and Com- 
puServe RLE (run line encoded) graph- 
ics. Another program called The C-64 
Graphics Converter (public domain) by Jer- 
ry L. Bethel (BETHEL on DELPHI) will 
import Koala and Doodle format pictures 
from the Commodore 64. There are also 
programs for converting to and from any 
IFF format, as well as the GIF standard 
(used in the IBM world). 

Although many of these programs will 
convert these outside images to a stan- 
dard ST low or medium resolution 
screen, a few will allow you to import pic- 
lures directly into Spectrum 512 format, 
thus maintaining the appearance of a 
many hued picture better than whittling 
it down to four or 16 colors. 



Smile and say "digitizer" 

Drawing on a computer is rarely easy 
Even given the best software tools and 
good input hardware (like a graphics 
tablet), it's still a pain compared to work- 
ing in more traditional mediums. Admit- 
tedly, the drawbacks are slight in 
comparison to the gains. In what tradi- 
tional artistic medium can you instantly 
change every instance of one color to 
another, clip portions of two images and 
seamlessly merge them together? Only 
with a computer 

But still, inputting the raw image to 
manipulate is rarely easy One solution 
many have taken is to use a scanner or 
a video digitizer These devices are used 
to break down images from outside 
sources and convert them into data the 
computer can display and manipulate. 




I he whole trend in wmpuler graphics 
increasingly has been te "malce il look 
real." This month the topic of Step I will 

be hardware, soltwara and graphia 
techniques that can make the ST's video 
output look its best. 




Both scanners and digitizers work in 
roughly the same fashion; it's the manner 
of input that differs. 

A scanner is usually a device with a 
small sensor that is passed horizontally 
over an image (usually a photograph or 
printed picture). Each time it passes, it 
scans the light reflected from the source 
image and breaks that down into numer- 
ical data. When that pass is completed, it 
then scans the next line Software then as- 
sembles all these "line passes" into a sin- 
gle image, which can then be saved to disk 
and/or manipulated. 

The human hand is too imprecise an 
instrument for this task so the common 
solution is to attach the scanner to a 
printer, usually a dot-matrix. The scan- 
ner's "eye" is mounted on or in place of 
the printer's print head, and the image 
to be scanned is fed into the printer like 



a blank piece of paper would be The con- 
trolling software then makes the printer 
move its print-head positioning mechan- 
ism to move the scanner across one line 
of the image When it has reached the end 
of that line, it lowers the print head and 
repeats the process. Really it's sort of like 
inverse printing, using the printer as an 
input device. 

Scanners are less often used for input- 
ting images for display on the computer's 
screen than for creating data for use in 
desktop-publishing software and other 
printing utilities. 

A video digitizer works slightly differ- 
ently The input is usually a standard com- 
posite video line, carrying the output 
from a video camera, VCR, video laser 
disk, television or even another computer 
Like the scanner, the digitizer breaks this 
image down line by line— actually video 
scan line by scan line. Because of this, the 
incoming image must be perfectly still. 
Therefore, either your subject must hold 
still for the required time, or, if you are 
using a videotape deck, you must be able 
to get a clear and stable (no flutter!) 
heeze-frame. 

The average video digitizer for the ST 
takes between ten and 25 seconds to scan 
a picture and convert it into a ST-usable 
image I'm talking about 16-shade or color 
images; the less tones and colors, the 
faster and "rougher" the scanning. There 
are digitizers which are known as "frame 
grabbers" that can "snapshot" a video im- 
age in real-time and turn it into a com- 
puter graphic nearly instantaneously I am 
not aware of a digitizer for the ST that can 
do this, and if there is one, it is no doubt 
expensive. 

The hardware isn't the only factor with 
these devices, the software that controls 
them can often be a major element. A 
number of good digitizers and scanners 
have been marred by buggy or inadequate 
software When shopping for one of these, 
don't rush out and buy the first one you 
see or one that sounds great in an ad. Get 
recommendations from people who've 
used them. Try to see some of the actual 
output and find out how hard it was to 
get that output. I've seen some great digi- 
tized images that were nearly impossible 
to reproduce using the same hard- 
ware/software combination. Remember, 
demos are designed to look the best they 
can, often at great expense and time. You 
don't want to purchase a device that re- 
quires hours of grueling work to get one 
great image, when another one would 
give you similar results in minutes. 
How many people have bought scan- 
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ners and digitizers in order to get realistic- 
looking pictures and images onto their 
computers? I'd say a lot, judging by the 
numbers of digitized pictures I've seen 
floating around. Admittedly, a lot are con- 
verted over from other computers. The 
lure is strong. You can capture and then 
edit images. The picture of myself that is 
now printed with this column is a digi- 
tized and retouched image. A live image 
of Megabit Mouse was digitized and then 
the cartoon character— me— was drawn 
in. One neat thing about digitized images 
is that you can exchange them with other 
people who have computers with compat- 
ible graphics formats like the aforemen- 
tioned GIF, IFF and so on. I have seen the 
faces of a number of STLOG associates 
and fellow DELPHI members only by 
means of digitized pictures we've ex- 
changed over modems and by way oi 
disks. 

I have one of each of these devices (the 
ComputerEyes video digitizer graciously 
provided by the fine folks at Digital Vi- 
sion), and although I rarely use them for 
making digital snapshots, I do use them 
whenever I need a realistic element iti a 
picture or animation. For example, I digi- 
tized some pictures of my hand for ;i 
scene at the end of the Art & Film Dim - 
tor video where a hand catches a disk. 1 
would have preferred to use an actual 
video of a real hand, rather than a digi- 
tized image, but there was no way to do 
that on an ST until now. 1 

TV en your ST | 

A little over a year ago I wanted t0 ani- 
mate a scene of Megabit Mouse hop])ing 
out of the ST screen and landing on lis 
keyboard. I didn't want him hopping onio 
a digitized picture of the computer, but 
onto an actual video image of it. I had no 
way to do that at the time, and the shot 
was abandoned. However, I could now do 
it rather easily In fact, with the flick of 
a few switches I can be typing this text 
right on top of MTV. These words I am 
typing are (at the moment I am writing 
them) appearing over the faces of some 
obscure band's rock video! A twist of a 
dial and the words disappear. 

How can I do this? Simple, I have a 
Genlock installed in my Mega ST. "Good 
for you, but what's that mean?" I hear 
many of you cry. A Genlock is a device 
that combines computer graphics with 
another video signal. More to the point, 
it places the computer image on top of 
the other video signal. With this device 
I can mix any low or medium resolution 
image with standard video. I'll have 



Megabit Mouse walking over the titles to 
Star Trek IV, then I'll place a CAD-3D 
generated starship over CNN's Crossfire, 
and maybe even whip out a paint pro- 
gram and draw a mustache and glasses on 
Dan Rather! All this and more is possible 
with a Genlock. 

A lot of us have waited for a long time 
for someone to produce a Genlock for 
the ST computers. As I write this, only one 
company makes such a device, and, un- 
fortunately, the current model is not for 
everyone (or even most of us). 

The Genlock I have is called the JRI 
Genlock, produced by John Russell Inno- 
vations (JRI). It is an add-on card that 
hooks into the ST's video-chip socket and 
grabs the data for the ST's screen display 
In the past I mentioned that this device 
would hook into the processor bus on the 
Megas and/or the DMA connector. I was 
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mm 




mistaken. This card terminates in a small 
box, external to the computer, which fea- 
tures six connectors. One is a composite 
video input (for the image to be Gen- 
locked upon), another is composite out- 
put (Genlocked image out), image out), 
in addition to a composite audio out (to 
output the ST's sound; there is no audio 
input. The standard ST monitor jack is 
carried through another port. The actu- 
al port of the ST itself is tapped into by 
the Genlock and inaccessible, hence this 
connector, and along with it is a port 
which outputs the Genlocked signal to an 
ST RGB monitor, meaning you can view 
video on your SC1224! The final port is 
a connector for the Genlock's supplied 
"remote control." 

On the side of the box are three 
recessed controls that can be adjusted 
with a screwdriver. One adjusts the hue 



like the tint control on many color TVs 
and composite color monitors, another 
the horizontal position of the computer 
image, and the third allows the Genlock 
to "lock" to the input video signal under 
changing thermal conditions. 

Installation is not easy and requires dis- 
assembly of the ST The case and RF 
shielding has to be removed, the internal 
power supply disconnected, and the ST's 
"Shifter" chip has to be removed. The 
Shifter is plugged into a socket on the 
Genlock board, which is itself plugged 
down into the Shifter's socket on the ST 
motherboard. The Genlock is hooked to 
the power supply, and special RF shield- 
ing must also be installed, in addition to 
reassembling the computer and attaching 
the small box with all the ports. The 
manual that comes with the Genlock ex- 
plains this installation, but JRI prefers a 
trained technician to do it, or to handle 
the job themselves, because, apparently 
it is easy to damage the board: The parts 
are extremely static-sensitive. JRI will in- 
stall it, if you want, but you'll have to ship 
your computer to them. 

Be warned, this device is not cheap. It's 
not overpriced either. However, the origi- 
nal planned price of $500 had to be aban- 
doned, John Russell told me, because at 
that price he would not have made any 
money unless every board produced 
worked perfectly and there were no 
defects. Perfection is extremely rare, and 
to cover repair and replacement costs and 
labor, the price had to go up. The current 
list price is $650, and includes the Gen- 
lock board, remote control and a disk 
with three sample animations and a pic- 
ture, lall for Genlock testing. 

Operation couldn't be simpler. The 
Genlock is software-independent, mean- 
ing it will work with almost anything. In 
layman's terms, the Genlock functions by 
grabbing the ST's screen and determin- 
ing which, if any pixels are a color which 
has been set to absolute black (000 on the 
palette). If it is any color but that black, 
it is plotted on top of the video signal 
coming in from the composite video-in 
port. If the pixel is color 000, it does not 
plot that pixel, allowing the video image 
to show through the resuhing "hole." 
Thus, to put Megabit Mouse on the 
screen, all I have to do is put him on a 
solid black background and make certain 
no part of him is color 000. If I tveed b\acV. 
on a character I'll use 001, which is close 
but doesn't vanish like 000. 

Controlling the Genlock is simple. Its 
remote consists of three two-position 

(to page 47) 
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BY ANDY EDDY 



]^|ast month we left oft our coverage halfway 
through the NEWS-WEATHER-SPORTS menu, a sec- 
tion of DELPHI that brings you up- to-the-minute in- 
formation. Let's finish up our coverage of this 
powerful area-then we'll get to some exciting de- 
velopments taking place in the databases, 
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And now the news. . . 

Again, here's the primary NFWS- 
WEATIIERSPOKTS menu; 



NEWS-HEfllHER-SPORTS Henu: 
Newsbrief 

dccu-Westher Forecasts 
OP Kevs Service I 
Ustrii Predictions ] 
ConpuBug I 
Financial Neus I 
Ksodo News fron Japan [ 
Novi« Neus i Reviews 



Press Releases: Business Hire 
Sports 

Huiz - four Keus III 
lodas in Histora 
Views on Neus 
HELP 
EXIT 



Asiiology fans will enjoy the diveisiiy 
provided Ijy ihe A\tm Predktutm subiuemi. 
You can gel ■'leadings" covering a varie- 
ty of siliialions: that day's horoscope, a 
weei^-long suniniary, compalibiliiy be- 
tween zodiac signs, even a guide for gift- 
giving. For an additional $12.50, yon can 
gel a hardcopy chart done up by Phyllis 
(DKl.l'Hl 11): PFIYL) of your own per- 
sonal astrological aspects. 

Compulmg is a regular column written 
about computers in the news, containing 
both serious subjects and satirical looks 
al oin favorite hobby It always provides 
provotalive reading. 

For serious investors or novice 
businessmen, the Financial Nnvs selection 
will help you brush up on your dollars 
and cents. Here you can find out the 
prices of gold and the curi ent value of the 
dollai, gel a listing ol NYSE or AMEX 
slocks, get a listing of the most active 
stocks that day and much more. I'his is 
what the Financial New.s menu looks like: 



Coparight (C) 1989 by the Associated Presf 
All rishts reserved, 



reviews of what is currently in the theat- 
ers and peek in on what's in the works tor 
future films, l)ut you can also seaich 
tbiough a database of reviews on previ. 
ously released films. Especially with the 
popularity of video cassettes, this is a 
good way to pic k and choose what movies 
are best (or you. 

Press Releases: Business Wire is a briefing 
room for up-to-date business dealings. 
There you can pick from vari.nis articles 
to keep you abreast of the happenings 
with the world's movers and shakers. 
Here's a sample of the PR menu: 



ting editorials, Views on Neuis is ihe place 
to do it. Among the featmes Ihey run is 
a column by Bob Fried called "Artie les of 
Easiing Strangeness." This connneniaiy 
on life always bring yom emotions to the 
surface, generally resulting in a smile 
Most people don't expect to get a c hu< k- 
le out of a computer activily, bul Fried 
usually breaks that misconception lo 



flP VIDEOTEX BUSINESS Henul 



General Business Hews 
Govt Econonic Figs 
Dollar/Gold 
Board of Trade 
Money Supply 
Stock Market Reports 
Dow Jones 
flP 68 Stocks 



SjP Averages 
NASDAQ 

Markets at a Glance 
Most Active Stocks 
NVSE Lists 
AMEX List 
EXIT 



Because the Japanese have a great deal 
of inlluence (jn how American business 
runs these days, Kyodx) News from Japan is 
im|)orlanl in keeping up with current af. 
lairs. I his menu is broken down into a 
l)uncli of c ategories, such as bonds, com- 
modities, govei iniient, money and stocks. 

lb prove this .section isn't just devoted 
lo serious topics, the next selection, Movie 
News 6f Retiiews, lets you check out what's 
going on in films. Not only can you get 
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tmniM (I) 198? lusinfis Uin Im. 

1 ;-««; Jl«£ Ht, UNlUSRHEIl COmiHIClIIOIS inc. FOBN IIBE ««MR rNt 
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i i-m mimmiim crlifirhurs to be ho!o ! or oS s !»! Ir ' 

lf««BF«CTORE« OF tlS.EIFE (OEEICHIUS PRTOCIsJsVsire 
Enter Iteti Kunber, HORE, or EXItI 

The Sporls selection duplicates the 
sporting scores and summaries that we 
lalked about last month as pari of ihe /l/^ 
Neius Service. Again, you lan get reports 
on any sport from here, as the section is 
broken down inio many submenus. 

When you choo.se die Qiiiz Your Nnus /Q 
selection, it runs some ()uestioiis past you 
lo lest your current-events knowledge No, 
there's no prizes— unlike the Fliph and 
Trivia Quest games that can be found on 
DELPHI— but no matter how well you do, 
it's fun and educational. 

Toduy in Hislory is a glance back at 
events that have taken plat e on this date. 
It's an interesting compendiiini of data 
from past historical happenings. 

We close up the NEWS WEATHER- 
SPORl'S menu with a SKi- yes, this is a 
strange place for a SKI, but in fact the 
Views on News SKi has no better place 
than right here. Here's the menu you'll see 
when you enter: 



UIEUS ON NEUS Menu: 

Archives 
Conference 
Forun (Messages) 
Features 

MAIL (Electronic) 
Poll 

UIEHS ON NEHS> 



Set Preferences 
Uho's Here 
Workspace 
Help (Hints) 
Exit 



riiough we briefly discussed this area 
in the May WHS Database DELPHI, just af- 
ter this SK; was introduced, they've real- 
ly polishetl it up I( you want lo chat about 
ciirrent events or read through some cut- 



pie(e.s. 

Fl-ee uploads 

* As we noted at the end of lasi monlh's 
. column, DELPHI was in the proiess of 
reprogianiming the database system lo 
permit free uploading of files. If you have 
ever uploaded a file before, you know that 
DELPHI previously had you leijuesi free 
lime from the SIC; manager before up- 
loading. In the meantime, l)olli Com- 
jJuServe and (;Enie had adopletl a policy 
of free uploads to make it easier on their 
u.sers. Now DELPHI has followed suit, and 
the results are great. 

Instead of uploading ihe file(s) to your 
workspace and then sul)niittiiig ii/tliein to 
the database (as was the previous pioce- 
dure), you can now type "SUB" al your 
workspace or any database section, iheii 
follow the various [jronipts lo nol only 
subinil Ihe file, bul also the list of key. 
words, the description and download 
names. Some additional bonuses have 
been implemented such as baK h ujjloads 
for file groups, and the ability to edit the 
contents until the submi.ssioii is complete 
Perhaps the most attractive feature is 
lhal you can do your upload process in 
pieces, and the system will keep the en- 
try "in holding" until you are ready lo 
submit it for inclusion in the databases. 
II you have the files uploaded bul aren't 
sure of what to put in the description, you 
can h(jld oil on that part until you are 
ready (oi vice versa). 

When you type "SUB" you will be 
prompted as to whether you want to use 
the new method or the old method, ihe 
latter of which re<|uires that you have the 
files already in place in your workspace. 
If you pick the new method, you'll see an 
indicator that your billing has In-en shut 
off while you go about your business. 

As we've noted, the most jjopulai lea- 
lure of any SK; is the ability to download 
files. If you have any files that you've ac- 
<|uired or written that arc in the public 
ilomain, plea.se take the lime to upload 
them to the ST SK;. Your (cllow DELPHI 
users will be happier for it! 

Well, I see that our time is up for this 
month. Next issue, we'll tell you how you 
can use DELPHI to make travel plans, 
fill next month, C; U online. 



ST-LOG JULY 1989 



YOU 



ONLY 
$9.95 
EACH! 






If you want to get the most out of ST-LOG, 
you're also going to want to get your copy of 
the disk. Each issue's disk contains all the ex- 
citing programs for that issue, including the 
programs whose listings could not be includ- 
ed due to space considerations. The ST-LOG 
disk version is truly an excellent software 
value. Order yours today! 





MicroCheck ST, 




Line Attack, 






Game 




Outline Plus, 
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Cupboard, 


MAY 


Monochrome 


MARCH 


Animated GFA 


1989 


Gray II and 


1989 


Input and more! 




more! 





Picture-Puzzle, 
Sounds-A-Like, 
ChemCalc and 
more! 




Ballbuster, 
MIDI Capture 
Safe Keeping 
and more! 



APRIL 
1989 



Multi-Paint, 
Font ID Editor, 
Monochrome 
Gray and more! 



FEBRUARY 
1989 



Flag Trivia, 
Super Spool, 
Desk Switch 
and more! 



I DO WANT 



D I S 



K I ONLY $995 EACH 



□ ST-LOG February 1989 DISK 

□ ST-LOG March 1989 DISK 

□ ST-LOG April 1989 DISK 

□ ST-LOG May 1989 DISK 

□ ST-LOG June 1989 DISK 

□ ST-LOG July 1989 DISK 



Name. 



Address. 
City. 



State. 



Zip. 



□ Payment Enciosed-Chaine My □ VISA □ MC 

# Exp 

Signature 

Aim $1.50 pottage and tandllng for oack disk ordend. 
Make clack payabla to: LFP, Inc. P.O. Box 07001, Los Anoilas, CA 10007 
California rasldantt add 0.5% 




Parade 



BY GEORGE L. SMYTH 



The program described here is availa- 
ble on this month's ST-LOG disk, in the 
databases of the ST-LOG ST users' group 
on DELPHI, and on BBSs and other on- 
line services throughout the country. Be- 
cause this program is "shareware," 
anyone who enjoys it should send the re- 
quested donation to the author. 

When I bought my Atari 520ST, I also 
purchased two pieces of software to get 
me started: a Pascal package and a graph- 
ics program. I bought the former because 
I needed to write some programs to 
replace those I had used with my old com- 
puter. I bought the latter because I was 
knocked out by the graphics capabilities 
of the ST. Two and a half years later, I am 
still intrigued with the ST's superior 
graphics power. 

These graphics capabilities apparent- 
ly also impressed David A. Pollette to the 
extent that he sat down and created this 
month's featured shareware program, 
Quess-A-Sketch, which combines the ele- 
ments of a graphics program and a word 
game. 

Guess-A-Sketch is designed to be played 
by two teams of two players each. The ob- 
ject of the game is to draw a picture 
representing a given word in such a way 
as to get a teammate to guess the word 
within the allotted 60 seconds. This is a 
difficult task, one that requires imagina- 
tion and a quick drawing hand. 

The opening screen requires each play- 
er to input his/her initials so that the com- 
puter can address each participant 



individually A choice of word files is then 
presented. The game includes one word 
file; others may be created by the Guess- 
A-Sketch word file editor, which is availa- 
ble to those who send in their $10 regis- 
tration fee. 

Three different-sized game boards are 
available, one with 39 spaces for first-time 
players, one with 63 spaces for average 
players and one with 71 spaces for dedi- 
cated players. 

The first time the game is played, it may 
be a good idea to use the practice mode, 
which allows game play without scoring. 
This mode is especially helpful if more 
than one player is new to the game. 

The program then rolls the dice to de- 
termine which team will begin. One play- 
er from this team is identified as the artist 
and his teammate as the guesser. The per- 
son designated to guess then turns his/her 
head while the other clicks the mouse but- 
ton. A word from each of the five topics 
is then displayed, one of which is chosen 
by the computer as the target word. The 
topics are labeled "person, place or 
animal," "object," "action," "difficult" and 
"miscellaneous." After ringing the bell 
and flashing the word eight times, the 
screen changes to a drawing board. At this 
time the guesser can face the screen and 
watch his teammate attempt to draw a pic- 
ture suggestive of the word. 

The individual drawing the picture has 
several tools to aid him. Besides having 
a pen with which to draw, the brush size 
can be changed, a straight line option is 
available, and the color of the pen may 



be altered. A fill option is also offered to 
speed the drawing process. 

The lower left corner contains the out- 
lined drawings of an ear, a pair of scis- 
sors and a plus sign. Clicking the right 
mouse button while pointing to one of 
these three areas brings up a large icon 
that indicates respectively, "sounds like," 
"cut" and "add." This is the level of play 
where imagination becomes important. A 
representation of the word can be drawn, 
portions of the word can be drawn, or its 
meaning can be altered and modified, as 
in the game Charade. 

The upper right corner of the screen 
contains the player's nemesis, the 
timekeeper. Starting at 60, it counts down, 
second by second, to zero. If the word is 
guessed before the minute has been 
counted, a key must be pressed to indi- 
cate success. 

If the word is correctly identified, the 
computer rolls the dice to indicate how 
many spaces the team's token will be ad- 
vanced. The successful team retains con- 
trol of the mouse with the team members 
swapping draw/guess duties. If the team 
is not able to guess the word, control of 
the mouse is turned over to the opposing 
team. The winner is the first team to land 
exactly on the final space This means that 
a team that is far behind still has a chance 
to catch up if their opponents run into 
bad luck with the dice. 

An interesting feature of the game is 
the option to redraw the graphic that was 
created for the last word. Another nice 
feature is the status display When "(S) = 
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1st STOP 

Computer Systems Ltd. 

7085 Corporate Uoy 
Dovton. OH 45459 



Toll-free Order Une 8(y-252-2787 
Tech/Info line 513-438-0551 



If you don't see it listed, ask! 
Same day shipment on most items 
We specialize in the Atari ST line 
No extra charge for credit cards 



HOURS: 
Mon-Fri 9 am - 9 pm EST 
Sal 10 am - 6 pm EST 



ST Gomes 

Captain Blood . ^ «32.95 

Carrier Command H'^ 

Dive Bomber 25. 9& 

Dungeon Master 25. as 

DM II - Chaos Strikes Back . . 

18.95 

Elite:::::::::::'' 23.95 

FALCON 28.95 

F15 Strike Eagle 25 95 

Gauntlet II 2|-9| 

Gunship 29.96 

Heroes of the Lance 27.95 

jg^ 35.95 

Kings Quest I, II, III, IV, V call 

Leader Board Duel Pak .... 16.95 

Leatherneck 26.95 

Missile Command 1 8.96 

Obliterator 26.95 

OutRun 22.95 

Shadowgate 33-96 

SlarGlider 2 27.95 

Test Drive 26.95 

Typhoon Thompson 22.95 

Universal Military Simulator . 32.95 



EUROPEAN TITLES 



ST Productivltu ond Rpplicotions 

SwiftCalc ST 48.95 

Thunder! 27.95 

Touch -Up 119 95 

Turbo ST S35.95 

UltraScript .•, ■ • D 

Universal Item Selector II . . 13.95 

WordUp (revised) 51 .95 

WordWriterST 48.95 



CAD3D(ver2) 64.95 

Calamus 'T„„c 

DataManager ST 48.96 

dBMANS.O 153 95 

DEGAS Elite 38.95 

Desk Cart ^- 68 95 

TimeWorks Publisher ST . . 79.95 
Easy Draw /Supercharger 98 95 

First Word Plus 62.95 

Flash 1.6 22 95 

FONTZ! 22.95 

G + Plus 22 95 

LDW Power 98.95 

Mavis Beacon Typing , 32-96 

Megamax Laser C 'Ij^f 

MIDI Recording Studio 26.95 

MultiDesk 19.95 

NeoDesk2 34 95 

PageStream 119.95 

PC - Ditto (IBM Emulator). . 64.95 

Personal Pascal 65.95 

PrintMaster Plus 25 95 

ProCopy 27.95 

Spectrum 512 48.95 

ST Talk Professional 19.95 

STAC 49.95 

STOS 38.95 



Ule certainly don't 
hove room to list 
evervthing. so if \fou 
don't see uihot you uiont 
here, coll onyuiay- 

Ule ore Rtori people 
from "uiov bock' ond 
we'll do our best to 

keep vou. our 
customers, satisfied. 



ST Horduiore 

ST's "II 

Cables <=a 

Disks <=a" 

Drive Master 36 95 

Hard Drives call 

Modems call 

Monitor Master 39.95 

Mouse Master 33,95 

Mouse Mat, Deluxe 8,95 

Mouse Mat, Regular 6 95 

Panasonic Printers call 

PC -Ditto II call 

Printer Ribbons call 

Spectre 128 149,95 

Spectre GCR call 

Star Printers oiW 

Surge Suppressors call 

Tweety Board (STereo) 39,95 
VideoKey 68,95 



S.5" 6eiwf ic Disks - .99 
IHth onv purchase - .89 
limilSO 



DI/C«VER 




KJ^^BiuSi^^^ir^^ 

t^ - A^low 1 0 busmesfdays for personal or company checks - Returns subjec to 20% 
« st^k fee - Defectives equire return authorization number to be accepted for repair or rep acement 
Pri^^ sul^ect to change - call for pnce and availability - We check all credit card orders tor validity, 1 



CIRCU #105 ON READER SERVICE CARD. 



Place 



Object 



D 1 f f 1 c u 1 1 



Ml sce-i - 
I aneou i 




C. I98S CREATIVE IMftQE^- 



STATUS" is visible at the bottom of the 
screen, choosing this option displays the 
number of the team that's winning, how 
many spaces ahead they are and the num- 
ber of times each person has had control 
of the mouse. 

Documentation that includes a full ex- 
planation of game play as well as regis- 
tration information is included. The text 
also includes suggestions regarding eti- 
quette of play, which one may or may not 
decide to follow. 

I hope that this program proves to be 
as much fun for your group as it was for 
ours. And please support the hard- 
working shareware programmers by send- 
ing them your contribution. . 



Three different-sized game 
boards are available, one with 
39 spaces for first-time 
players, one with 63 
spaces for average players 
and one with 71 spaces for 
dedicated players. 




George L. Smyth has a degree in psychology 
from West Virginia University and is current- 
ly employed as a programmer. He is the author 
of a series of tutorials on programming in 
FORTH. 
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ow we're going to make sure that the 
file chosen by the user of our program 
actually exists, and also get some other 
important information about it by using 
the GEMDOS Fsfirst call (function num- 
ber $4E). Fsfirst is a useful call; it returns 
just about every piece of pertinent data 
about a particular file, including its crea- 
tion time and date, its size and its name. 

But you say, "Wait, we already know the 
name of this file!" In the case of our cur- 
rent example program, this is true; but 
one of the real strengths of the Fsfirst call 
is that it can use the wildcard characters 
"*" and "?" to search for all the files in 
a given directory that match the specifi- 
cation. In a future column we'll be using 
the Fsfirst call (and its companion, Fsnext) 
to read a disk directory, but that, as I said, 
is for the future. 

Getting back to our example program, 
we've set up a subroutine called fsfirst, 
which expects to be passed two 
parameters: the address of the file specifi- 
cation for which to search (which can con- 
tain the wildcard characters "*" and "?') 
and the search attribute. (Notice that the 
first "f ' is not capitalized in the name of 
our subroutine, as it is in the name of the 
GEMDOS call.) 

Before we use Fsfirst, we'll need to tell 
GEMDOS where to store all the informa- 
tion that will be returned from the call. 
The way to do this is with another GEM- 
DOS call, Fsetdta (function number 
$1A) — and this is the first thing our fsfirst 
subroutine does. Fsetdta must be passed 
two parameters: the address of a 44-byte 
buffer (called the OTA, or disk transfer ad- 
dress buffer), which will be used to store 
the information returned from the Fsfirst 
call, and the function number $1A. In the 
example program, the DTIA buffer is given 
the label dta. 

When we call our fsfirst subroutine, the 
address of the file search specification is 
passed in register a5, and the search at- 
tribute is passed in d5. These registers will 
have remained intact throughout the 
Fsetdta call, since trap #1 preserves a3-a6 
and d3-d7. The search attribute word speci- 
fies the parameters shown in Figure 1. 

To specify different search attributes, 
you simply set the bits for the attributes 
you wish to use. An alternative method is 
to add together the amounts in the 
"Value" column for the attributes you 
wish to use. The example program uses 
a search attribute of zero, which means 
we're only going to search for an ordinary 
file which is not write-protected. 

After the Fsfirst call, dO will be set to 



zero if a file matching the search specifi- 
cation was found. If the search failed, or 
some other error occurred, dO will con- 
tain a negative number So, after perform- 
ing the GEMDOS Fsfirst call, our sub- 
routine uses the tst.l instruction to set the 
N (negative) and Z (zero) flags in the con- 
dition code register according to the con- 
tents ofdO, then returns with the usual rts. 

Note that rts does not affect the condi- 
tion codes, so when we return from the 
fsfirst subroutine we can simply beq 
(branch if equal to zero) to the code that 
follows. If the Z flag was not set, we print 
an error message and branch to our exit 
routine, labeled byebye. 

If the Z flag was set upon returning 
from Fsfirst, we found a file that matches 
the search specification, and the OTA 
buffer contains all of this file's vital statis- 
tics, as shown in Figure 2. 

Is Ikere umf 

The next thing we need to do is find 
out whether the machine our program is 
running on has enough free RAM to read 
the entire source file into memory all at 
once. Our file copying program is 
designed to do its reading and writing in 
one pass; if there isn't enough memory 
to read in the whole source file at once, 
the example program just refuses to go 
any further. Come to think of it, there's 
a good project for the more adventurous 
and self-motivated among you — 
modifying the example program to copy 
a file of any size. The program would have 
to read and write the file in several pass- 
es. Any takers? 

To find out whether there's enough 
memory for the copy operation to take 
place, we'll use yet another GEMDOS call: 



tont 



,1 is imp*' 
of the tst iitstru 



use 



the much-feared and dreaded (and right- 
ly so, as we'll explain in a moment) Mai- 
loc call. 

Malloc (function number $48) is one of 
the most important calls in the GEMDOS 
library. It provides a way for ST applica- 
tions to allocate memory that is protect- 
ed from use by other applications. (Its 
companion/opposite call, Mfree, is dis- 
cussed below.) Malbc expects to be passed 
only one parameter, a longword contain- 
ing the number of bytes you wish to allo- 
cate. When you return from Malloc, dO 
contains the starting address of the block 
of reserved memory, or zero if the amount 
of memory requested exceeds the amount 
available. 

However, if you pass a parameter of - 1 
(instead of a reserve amount) to Malloc, 
the call returns the size of the largest free 
block of memory in dO. The example pro- 
gram uses this version of Malloc, then 
compares the result with the size of the 
source file, which is contained in dta + 30. 
If the size of free memory is smaller than 
the size of the source file, the bio (branch 
if lower than) instruction takes us to 
no memory, which prints a message tell- 
ing the poor user that he doesn't have 
enough memory to copy the file, and 
exits. 

If there's enough free memory to load 
the entire source file, we use the Malloc 
call again. Since the size of the source file 
is contained in dta + 26 (after the Fsfirst 
call, remember?), we can use the follow- 
ing code to reserve the memory we need: 

Mowe.l dta+26,-Csp3 

Move ttS48,-Csp) 

trap ttl 

addq tt6, sp 
If dO is not zero after this call, we 
branch over the code labeled no memory 



^ "long 



II form 



ciie« when testing re 



suits 



from a file read or write call, because 
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and continue on with our program. It's 
highly unhkely that this Malloc will fail — 
after all, we just used Malloc(- 1) to deter- 
mine that enough free memory existed — 
but better safe than sorry (an obnoxious 
truism that often holds very true in com- 
puter programming). 

fk« irMble with Malloe 

Now it's time for a short digression 
from our example program to discuss the 
problems with the GEMDOS Malloc call, 
mentioned briefly above. In the original 
ROM TOS (Version 1.0) and the newer 
TOS that was shipped with the Mega ST 
(Version 1.2), the GEMDOS Malloc call 
suffers from a particularly nasty bug. If 
an application calls Malloc more than a 
certain number of times (without using 
a corresponding number of Mfree calls), 
the ST gets confused. 

If your application exceeds the critical 
number (which is usually somewhere 
around 40), strange things will start to 
happen. You may get spurious "out of 
memory" errors, files may refuse to load, 
and eventually you'll crash or lock up. The 
interval before the actual crash, however, 
is very dangerous indeed. If you try to 
write data to a disk when the system is in 
this confused state, that disk will almost 
certainly be corrupted beyond repair. The 
only solution when these symptoms start 
to appear is to immediately reboot your 
computer; once things get messed up in 
this way, they stay messed up. 

The reason for this disastrous bug? 
GEMDOS maintains a list of all the blocks 
of memory allocated with Malloc, and 
when an application uses Malloc to 
reserve memory, another entry is simply 
added to the end of the current list. Un- 
fortunately, the buffer that holds the list 
of Mallocs is of a fixed size, and GEMDOS 
does not check to see if it's already at the 
end when it adds a new entry. When the 
critical number is exceeded, new entries 
will actually write over other important 
GEMDOS data structures, wreaking havoc 
with the ST's file- and memory- 
management systems. (By the way, the Mal- 
loc bug is caused by the same problem 
which is responsible for the ST's well- 
known "40 folder" bug.) 

Advance word has it that the new TOS 
1.4, which will soon be released by Atari, 
fixes the Malloc bug and the 40 folder bug, 
by allowing true dynamic sizing of the 
memory allocation list. In the meantime, 
I recommend that you try to get a copy 
of Atari's EOLDRXXX.PRG, a program 
which runs from the AUTO folder and al- 
leviates the problem by expanding the 



fixed memory list buffer to any size you 
specify. This program is available from 
Atari, or on many of the popular infor- 
mation services such as DELPHI, GEnie 
and CompuServe. If you're using a hard 
drive, this program is a necessity. 

Luckily, since our example program 
uses only one Malloc call, it will not run 
into the Malloc bug. But if you ever write 
a program that needs to allocate memory 
in several chunks, you'll need to be aware 
of these potential problems. 

M, in the siddle %lm 

Okay, back to the example program. Af- 
ter successfully allocating a block of 
memory to read in the source file, we 
store the starting address of this memory 
in the variable copy_bujfer, with the in- 
struction: 

noye.l dO, copu_buf f er 

We then print a message to let the user 
know his computer is going to be busy for 
a little while, and attempt to open the 
source file in "read only" mode. (The 
GEMDOS Fopen call was discussed in the 
January '89 Assembly Line.) We've written 
a subroutine called open^ile that does 
this; the subroutine is passed the mode 
in dO and the address of the null- 
terminated filename in aO. Before return- 
ing, it uses the tst.l instruction to set the 
condition codes based on the results of 
the Fopen call. If the N flag is set, we use 
the bmi instruction to branch to the label 
bad_open, which prints an error message 
and branches to the exit code at 

outta here. Otherwise, we save the file 

handle with the instruction: 

nove dO, handle 

Now (at last!) we're ready to start copy- 
ing the selected file. The first thing we'll 
do is read in the entire source file, stor- 
ing it in our allocated block of memory. 
To do this, we'll use the GEMDOS Fread 
call (function number $3F). Like the Fopen 
call, Fread was discussed in the January '89 
Assembly Line. Our subroutine, called 
read_file, expects to be passed two 
parameters: the number of bytes to read 
in dO, and the address of the buffer into 
which to read it in aO. The example pro- 
gram calls the read^^file subroutine with 
the following code: 

noye.l dta+26, dO 
Mowe.l copu_buf f er, aO 
bsr read-file 

The size of the source file is still con- 
tained in the DTA buffer, as returned 



from the Fsfirst call. So we just move the 
contents of dta + 26 to dO and the contents 
of copy_buffer (which holds the longword 
address of our allocated memory) to aO. 

Upon returning from the read file 

subroutine, dO contains either a negative 
number (an error message) or the num- 
ber of bytes successfully read from the file 
Our program moves this value to d7 tem- 
porarily, while it closes the file. This is 
necessary because the Fclose call alters dO. 
Then, after closing the file, we test d7 to 
see if an error occurred during Fread. If 
d7 contains a negative number we branch 
to the label bad_read, which prints an er- 
ror message and branches to the exit 
code. 

Ihe iRomeM km nWki for (MiKOSt) 

At long last, we're coming to the 
payoff — the point where we can actually 
write the destination file and complete 
our copy program. But first (you knew 
there had to be one more delay, didn't 
you?), we have to discuss yet another bug 
in yet another GEMDOS call. 

Up until now, all the GEMDOS file- 
handling calls that Assembly Line has dis- 
cussed were the ones that deal with 
manipulating files that already exist. To 
create a new file, we'll use the GEMDOS 
Fcreate call (function number $3C). Unfor- 
tunately, there's a small but pesky bug in 
Fcreate, which causes it to sometimes cre- 
ate duplicate files (files with the same 
name), if the filename you're trying to cre- 
ate already exists. Fcreate is supposed to 
first delete the existing file when this oc- 
curs, but for some reason this doesn't al- 
ways happen. 

Therefore, before creating a new file 
under GEMDOS, it's a good idea to first 
explicitly delete any existing file with the 
same name. To do this, we use the Fdelete 
call (function number $41). Fdelete is 
passed only two parameters: the null- 
terminated filename you wish to delete 
and the function number itself In the ex- 
ample program, we pass the address of 
the destination filename, located at dest. 
It doesn't matter if the file we're trying to 
delete doesn't already exist, so we ignore 
any errors from the Fdelete call. 

the yt\ (ir miXm 

Now we can create our destination file. 
The GEMDOS Fcreate call takes three 
parameters. First is the attribute word, 
which has the same format as the attrib- 
ute word specified for the Fsfirst call, 
described above. By specifying different 
attributes, you can create subdirectories 
and "hidden" files with the Fcreate call. 
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Our example program uses zero for the 
attribute, which means that the file we cre- 
ate will be a normal, read/write file. 

The second parameter passed to Fcre- 
ate is the longword address of the null- 
terminated name for the newly-created 
file, and the third parameter is the func- 
tion number itself As with all of our file- 
handling calls, we've written a subroutine 
to handle Fcreate, called create_/ile. The at- 
tribute word is passed to create_file in dO 
and the address of the filename in aO. 

Fcreate returns either a valid file handle 
in do or a negative error number. If we 
return from create_ftle with the N flag set, 
we branch to the label bad_^create, which, 
as usual, prints an error message and ex- 
its. Otherwise, we save the file handle in 
handle and proceed to write the destina- 
tion file. 

The usage of the GEMDOS Fmrite call 
(function number $40) is identical to the 
Fread call. The only difference is the func- 
tion number. The subroutine ivrite_file 
handles the Fread call in our example pro- 
gram; it is passed the number of bytes to 
write in dO and the address of the buffer 
from which to write in aO. The code in 
our example program is very similar to 
the code used to read a file: 

nowe.l dta+2G,dO 
nove.l copu_buf f er, aO 
bsr write_file 

Upon returning from xirrite^ile, dO will 
contain either the number of bytes writ- 
ten without error or a negative error code. 
Just as with the read_^le call, we move the 
result temporarily to d7 while we close the 
open file. Then we use tst.l d7 to see if an 
error occurred during the writing of the 
data, and branch to the appropriate error- 
handling code if necessary. 

It is important to use the "long" form 
of the tst instruction when testing the 
results from a file read or write call, be- 
cause the number of bytes read or writ- 
ten can easily exceed a word value. If the 
amount is larger than 32,767, a tstxv in- 
struction will see it, erroneously, as a 
negative number. 

Our example program doesn't handle 
one possible error that could occur while 
writing to a disk: running out of space on 
the disk. If this happens, GEMDOS does 
not report any error to you. It's up to you 
to make sure that the number of bytes 
that were actually written is the same as 
the number you wanted to write. After 
checking for errors, you should compare 
the value returned from Fwrite with the 
number of bytes you tried to write. If they 
are not equal, chances are that you ran 
out of room on the destination disk. In 



which case you should use Fdelete to de- 
lete the resulting partial file and let the 
user know that there's no more room on 
the disk. 

(iive bek ike %m\f. 

When we're all finished with the copy 
operation, we still need to tie up one 
loose end before we exit the program. We 
have to give back to the system the 
memory we allocated with Malloc. The way 
to do this is with Malloc's companion call, 
Mfree. Mfree takes two parameters: the 
longword address of the allocated 
memory you wish to free, and the func- 
tion number, $49. The memory address 
must be the same as the value returned 
from Malloc. You can't Mfree memory that 
wasn't first allocated. 

After the example program calls Mfree, 
we print a message asking the user to hit 
a key. When he/she does, we exit the pro- 
gram by calling the GEMDOS PtermO 
function. 



everything you need to do are already in 
the program.) Another good idea might 
be to allow retries after disk errors. Or to 
allow the user to make multiple copies 
without rereading the source file. The file 
handling subroutines in the example pro- 
gram will be useful in future examples, 
so be sure to save a copy of the source 
code. 

Next time, we'll see how to modify our 
file-copying program to search a directo- 
ry for files that match a "wildcard" specifi- 
cation, and introduce the concept of 
GEM alert boxes. Till then, code away! ■ 




m to dt 

Our example file-copying program is 
not perfect, by any means. For one thing, 
it assumes that you aren't trying to copy 
a file to the same disk (or subdirectory). 
Therefore, it's useless on a single-drive sys- 
tem, unless you use a RAMdisk to hold 
temporary files. You might try modifying 
the example program to prompt for a 
disk swap after reading the destination 
file. (Hint: The needed subroutines to do 



Charles F. Johnson, by using some as yet un- 
discovered laws of nature, has managed to find 
the time to be both a professional musician and 
a professional programmer. In his musical 
career, he has played with such artists as Chica- 
go, George Duke, Al Jarreau and Stanley 
Clarke. His programming accomplishments in- 
clude Mouse-Ka-Mania, Desk Manager, 
ARC Shell and, along with his partner, John 
Eidsvoog, G + Plus and MultiDesk. He and 
John are the owners of CodeHead software. 







Figure 1 : ATTRIBUTE WORD 


Bit 


Value 




0 


$00 


Return files which have normal read/write access. 


1 


$01 


Return files which are write-protected. 


2 


$02 


Return "hidden" files (not visible on the desktop). 


3 


$04 


Return "system" files (not visible on the deslctop). 


4 


$08 


Return the volume name of a disk. 


5 


$10 


Return subdirectories. 


6 


$20 


File has been written to and closed (also known as the "archive" bit). 





Figure 2: DTA BUFFER STRUCTURE 


Offset 




0-20 


Reserved for internal use by GEMDOS. 


21 


File attribute. 


22-23 


Time of file creation (in standard GEMDOS format). 


24-25 


Date of file creation (in standard GEMDOS format). 


26-29 


Size of file, in bytes (longword). 


30-43 


Filename (8-character name, 3-character extension). 
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STEP ONE 



(from page 34) 

switches and a dial. The dial is used in 
conjunction with the third switch and al- 
lows you to either fade the computer im- 
age on top of the video image or select 
between the two: one or the other or a 
ghostly half-and-half image in between. 
Switch one turns the Genlock on and off 
Switch two allows you to flip between 
color and monochrome monitors (or tog- 
gling it quickly to mono and back will 
reset the computer). Switch three turns 
"keying" on and off, which effects how the 
dial operates. 

Genlocked output can be either com- 
posite video or to an SC1224. The com- 
posite output, which works even with the 
Genlock off, seems to be at least as good 
as that provided by Practical Solutions' 
VideoKey It videotapes nicely and looks 
good on a TV. The Genlocked output to 
the ST's own RGB monitor is both better 
and worse than the composite output. It's 
better because the clarity and sharpness 
of the RGB output surpasses that of the 
composite output. It's worse because the 
overall image is darker, less vibrant, and, 
because of the combination of multiple 
video signals, there's a slight quiver to the 
screen. 

There are some hardware limitations. 
First, the Genlock does not work in 
monochrome because the ST's high reso- 
lution runs at 70 Hz, and composite video 
is 60 Hz, meaning the timing is incom- 
patible. Second, this Genlock does not 
feature "overscanning," which means mak- 
ing the computer image fill the entire 
screen. The video image fills the entire 
screen, but the ST image stops at the 
screen borders. If you make the back- 
ground color black, the borders become 
black, and the video image gets "boxed 
in" as well, somewhat solving that 
problem. 

The third and most serious limitation 
is that the current model of the Genlock 
can only be used on a Mega ST, because 
the board contains a fan to keep the 
board from overheating and to prevent 
heat buildup inside the Mega and sits so 
high it could not fit in the less roomy 
cases of 520s and 1040s. Also, the small 
box with the monitor and other connec- 
tors hangs out of the processor bus access 
panel on the back of the Megas, an open- 
ing which does not exist on the 520 or 
1040. JRI is testing a 520 and 1040 Gen- 
lock board, but at this point cannot 
guarantee if and when it will be available. 

Problems? Few, all things considered. 
I've had no trouble Genlocking with any 
TV signal. The only trouble I had with 
Genlocking on the output from a VCR 



was with a few tapes that I suspect have 
copy protection on them. My tape of 
2001: A Space Odyssey produced a noticea- 
ble horizontal band of distortion on the 
Genlocked picture. The JRI Genlock 
manual warns about this. 

Another small hitch appears when I try 
Genlocking on top of the composite out- 
put of my other ST. The Genlocked screen 
didn't seem to synch up properly, and 
would be vertically out of position many 
times. Interestingly, just plugging and un- 
plugging the interconnecting video cable 
causes the vertical position to change, and 
with a few tries I can usually get them in 
synch. I'd guess this kind of problem can 
be corrected with a simple signal- 
synching box as used by TV stations, 
video-editing facilities, and even high 
school audio-visual classes. 

The color/mono selection switch on the 
Genlock's remote control is neat, because 
with it you could plug an RGB monitor 
into the Genlock port and a monochrome 
monitor into the standard ST monitor 
port and toggle between them using that 
switch. This would eliminate the need for 
a switchbox, so I at first stowed my Moni- 
tor Master in the closet. I later realized 
that while this works, when the RGB mo- 
nitor is plugged into the Genlock output 
jack, the brightness of the output is low- 
er that usual, and the intensity of the 
colors is not as bright. This is noticeable 
on my old 1985 SC1224 made by Panason- 
ic for Atari, this particular run of moni- 
tors can produce a much brighter screen 
than all later models, and is considered 
by most ST enthusiasts to be the best RGB 
Atari ever sold, and would be even more 
evident on the dimmer screens of later 
SC1224S. 

While this was fine when using the 
Genlock, I didn't like it for my other work, 
so I dragged out my Monitor Master 
again, hooked both monitors back to it, 
and plugged it into the Genlock's stan- 
dard monitor out jack. I plug it into the 
other port only when I want to use the 
Genlock features. What we need is a 
switchbox which let's you select between 
two monitors and two different monitor 
ports! Interestingly, if you have a 
color/mono switchbox hooked up with a 
Genlock, toggling the switch on the 
switchbox itself will just cause the screen 
to go bananas, not reboot and switch reso- 
lutions. To switch monitors in this fashion 
you have to toggle the switches on both 
the switchbox and the Genlock! 

The uses for a device like this are so 
numerous as to defy listing, covering ap- 
plications from tinkering to profession- 



al output. You could make a cartoon 
character interact with real actors, su- 
perimpose titles over video, or even just 
get silly and doodle over your least 
favorite TV show. 

If you are interested in the JRI Genlock, 
you can get more information by contact- 
ing them at JRI, P.O. Box 5277, Pittsburg, 
CA 94565; 415-458-9577 It's best to call 
before 1p.m. PST. 

The sum off its parts 

Any one of the products or techniques 
described above can be useful in jazzing 
up the graphics on your ST. Using two or 
more of them in combination can yield 
even more impressive results. The ST's 
graphics may not be able to compete 
head-to-head with those of a graphics 
workstation, but as you can see, the ST is 
not lacking in useful and powerful tools. 
Take those tools, add a little talent and im- 
agination, and you may find that the com- 
bination will produce results you hadn't 
thought possible on an ST.i 




Blissfully ignorant of the realities of time and 
space and plain old common sense, Maurice 
Molyneaux hopes someone will someday dis- 
cover "retroactive reincarnation" so that when 
he dies he can come back in a previous life as 
animation director Chuck Jones. His greatest 
fear would be to come back as Wile E. Coyote, 
and in the process have to learn some humility. 



Finally an advanced ST book that 

doesn't require a knowledge of pro- 
gramming. Ralph C. Turner's 159- 
page At3f/ ST Book begins wliere 
your owner's manual leaves off. 
"Arguably the best ST users' guide 
to date." [STart magazme, May 



1989). $16.95 



The 

Atari ST 
Book 




Tips, Instruciions, 
Secrats and Hints 
for the 520, 1040 
and Mega STs 



$2.00 shippmg. 
Check, money 
order. Visa/Mas- 
terCard. Index 
Legalis PuDlishmg 
Co., P.O. Box 
1822-37, Fairfield. 
lA 52556. Tel: 
515-472-2293. 



CIRCIE #107 ON REAOER SERVICE CARD. 



ST-LOG JULY 1989 



47 



THE COMPUKID 
CONNECTION: 

Involving Young Children in ST Graphics Design 



Note: Drie to the large size of the program 
associated with this article, it is available only 
on this month's disk or in the databases of the 
ST-LOG ST user's group on DELPHI. 

1^1 o matter where or in which culture 
they live, little children begin to scribble. 
The scribbles may seem formless and pur- 
poseless to adults, but the activity is pur- 
poseful to the child. In scribbling, there 
is a pattern to the placement of the scrib- 
bles and to the directions of the strokes. 
According to Rhoda Kellogg, a leading 
authority on children's art, there is a cer- 
tain sequence in the development of 
drawing skills that is followed by all chil- 
dren. After experimenting with scribbling 
for some time, eventually the child begins 
to draw shapes, and, after that, outlines 
around the shapes. Soon after that comes 
the first attempt at what adults would con- 
sider representational art — drawings that 
depict a form that the adult perceives as 
an actual house or person or tree, etc. 
While children of the '80s still use crayons 
and paper to draw, they are also taking 
advantage of the powerful graphics capa- 
bilities of computers like the Atari ST. 
Does a small child use a computer draw- 
ing program the way he uses a crayon? 

Not really, according to Michael Marks, 
director of Creative Discovery School in 
Champaign, Illinois. Marks has been us- 
ing a color 520ST in an open classroom 
for several months. The computer is one 
of many activities in the classroom that 
the 19 preschool- and kindergarten-aged 
youngsters can choose. All of the students 
have had at least some experience with 
the computer; about one-third of them 
choose to use it on a regular basis. They 
use it without any adult help; all disks are 
prepared for auto-booting. Although they 
work independently, they rarely work 
alone. While one individual controls the 
mouse, a host of on-lookers participates 
in the computing experience, offering ad- 
vice and commenting on progress. 
Among the most popular programs are 
not only games, but also a group of graph- 
ics design programs I have written: 
KidGrid+ (MichTron), Kidshapes (freely- 
distributed) and a version of Draw It!, a 
program on this month's ST-LOG disk. 

Drawing on the computer is "tapping 
a different cognitive process, having more 



by D.A. BRUMLEVE 

to do with math, patterns and shapes," 
says Marks. "The computer is giving them 
an experience they could not get through 
drawing alone. The FILL option gives 
them a different appreciation and under- 
standing of closed and open shapes." The 
children enjoy getting a reaction from the 
computer, seeing their own actions chang- 
ing what is on the screen. "They love be- 
ing able to quickly edit their work. Young 
children usually concentrate on outlines, 
and this gives them an opportunity to ex- 
periment, and it makes color and pat- 
terns much more important." 

According to Marks, computer drawing 
develops different skills than drawing 
with a crayon. "If you can draw on a com- 
puter, it doesn't mean you can draw on 
paper, because mouse-drawing doesn't de- 
velop hand strength or proper grip, and 
the indirect eye-hand coordination is 
different." While this may seem to be 
negative, what it means is that a computer 
can be extremely helpful to children who 
have limited fine motor skills. 

As Kellogg found with scribbling, 
Marks has observed a sequence to graph- 
ics work on the computer, but the se- 
quence is different. First the children 
were interested in color; using KidGrid + 
and Kidshapes, they would change the 
colors of an existing picture. Then they 
began to work with color and shape pat- 
terns. In general, they are not yet putting 
these patterns together to create represen- 
tations, yet all of these children are capa- 
ble of representational art on paper. The 
recent introduction of Draw It' is moving 
these young users more toward represen- 
tational computer artwork. 

While very young children are more in- 
terested in the processes of filling and 
drawing than in the products they create, 
older children are more likely to use a 
computer as adults do. Children may 
draw for pleasure, but the similarity be- 
tween a drawing program and a desktop 
publishing program is not overlooked. 
Children, like adults, may use a graphics 
design program to produce charts and 
graphs, posters, comic strips, newspapers, 
and the like. My oldest son, Danny (sixth 
grade), draws maps of story scapes to as- 
sist him in playing adventure games. Sons 
Willy and Joey (both age nine) have devel- 
oped impressive portfolios of their com- 



puter art. Carl, a member of our children 
users' group, was inspired by his mother's 
needlepoint pillow and created, pixel by 
pixel, a picture of a rose. Seth, another 
child in our group, uses his drawings to 
illustrate his short stories. Children in a 
second grade classroom in our local pub- 
lic school are using their ST to produce 
illustrated stories and reports. An infor- 
mal poll of 20 local children indicated 
that graphics design programs are second 
only to games in their importance as a 
child's enjoyment of a computer. 

Most of these older children have 
learned to use sophisticated drawing pro- 
grams that were designed for adults. In 
some cases, the child is able to use all the 
functions offered by the program. Other 
children have learned to use some of the 
functions, and they ignore the ones they 
haven't used. For some, the use of an 
adult-oriented application is appropriate, 
but for many, especially those under nine 
or ten, it is not. Many features of these 
programs, such as menus, file-selector 
boxes, technical terminology in alert box- 
es, brush and fill pattern editors, color 
palette editors, etc., may be a boon to 
adults, but they can add to a child's frus- 
tration and confusion. 

A simple paint program 

Draw It' is a children's paint program 
designed to provide a bridge for later 
work with Neochrome, DEGAS, Art Director 
and other more sophisticated graphics 
design software. The program provides 
experiences with computer art involving 
the two most basic graphics design oper- 
ations: drawing and filling shapes with 
the mouse. Children as young as two may 
be able to enjoy working with Draw It!. 
The target audience for this program is 
between three and nine years of age. 

Getting started 

Separate high and low resolution ver- 
sions of Draw It' can be found in archived 
(.ARC) files on your STLOG disk. First, de- 
ARC the files following the instructions 
found on the disk. Then if you have a 
monochrome monitor, copy the files 
MDRAW_ITPRG and MSHOW_IT.- 
PRG to a freshly formatted disk. If you 
have a color monitor, copy 
DRAW__ITPRG and SHOW_ITPRG in 
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stead. (The .LST files contain the GFA 
BASIC source code for the programs and 
are needed only if you want to examine 
the listing.) Although these files are 
small — about 40K total — when you save 
pictures created with the program, a large 
data file of about 115K will be created on 
your disk. The picture file for the color 
version is called DRAW_ITI.DAT; the 
monochrome version is MDRAWIT1.DAT. 
The programs will run properly from wi- 
thin a folder or from a hard disk, but any 
existing picture file must be in the same 
folder. 

The monochrome and color versions 
have some differences. In the colcjr ver- 
sion, you can draw and fill in any of 12 
colors. In the monochrome version, of 
course, drawing is limited to black and 
white. In lieu of fill colors, the 
monochrome version offers a limited 
number of fill patterns, available only in 
black. In addition, the monochrome ver- 
sion offers a PRINT option. Most printers 
do not print colors well, so I have not in- 
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eluded a PRINT option in the color ver- 
sion. If you happen to have a color 
printer, you can print the screen with a 
screen dump by pressing Alternate and 
Help at the same time. In each version, 
a white easel fills most of the screen, and 
the drawing options are above it. 

Using the program 

Both versions offer two rows of options. 
The row at the top of the screen includes 
the following: 

• DRAW sets the drawing design mode. 
If you move the mouse on the easel with 
either button down, a line will be drawn 
on the easel in the currently selected 
color. Three sizes of drawing "nibs" are 
available. Click the DRAW option repeat- 
edly to see the nib sizes. 

• BLANK completely erases a picture. 

• UNDO erases the last drawing action. 
The UNDO function works even if you 
have selected colors or other options 
(even BLANK), but not if you have moved 
on to the next picture. Please note that 
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if you click BLANK twice in succession, 
clicking UNDO at that point will restore 
the first blank easel, not your original 
picture. 

• PIC * indicates the page number of the 
picture currently displayed. Click on PIC 

• to move to the next picture. Five pic- 
tures are available. If the PIC * option is 
clicked when picture No. 5 is on the 
screen, the first picture (PIC I) is again 
shown. 

• EXIT allows you to save your work and 
leave the program gracefully. Alert boxes 
are used to help prevent accidental 
exiting. 

In the color version, the FILL option 
sets the filling design mode. If you click 
inside an enclosed shape on the easel 
with the FILL option selected, the Cur- 
rently selected color will fill the shape 
The second row of options are the vari- 
ous colors with which you can draw or fill 
on the easel. 

As mentioned, the monochrome ver- 
sion has a PRINT option. The color op' 




lions (black and white) and a fill pattern 
box are positioned in a second row of op- 
lions. Click once on the fill pattern box 
to select the filling design mode Clicking 
icpcaiedly on the box will display all of 
the available fill patterns. 

Draw Iff is niy seventh graphics dt_ ^n 
program (or children. Some of the earli- 
er programs have liad a more successful 
user interface than others. I have had 
feedback fnim many users (and from par- 
ents and teachers of users), which has 
hel])( (l me develop programs that are eas- 
ier lo use. Draw It! is much easier to use 
than an adult paint program, and not 
only because it is limited to drawing and 



filling operations. Many additional fea- 
tures contribute to the kid friendliness of 
the program. 

Undifferentiated mouse-button 
response is one of the most significant. 
This means that the program will react 
anytime the mouse is clicked on a target, 
no matter which button is used. It doesn't 
inatter whether the child presses the left 
button or the right, or even both buttons; 
the result will be the same. Many children 
between three and nine cannot tell the 
difference between left and right, and this 
feature saves them much frustration. 

Children tend to move the mouse 
about rather wildly, and accidental selec- 
tions can occur Usually, I avoid situations 
in which the child must hold the mouse 
button down while moving it ("dragging 
the mouse"). However, a primary purpose 



for Draw It! is to prepare the child for 
more sophisticated design applications, 
all of which require at least some drag- 
ging operations. I decided to include it, 
but special effort is taken in the program- 
ming to avoid inadvertent selections of 
options while drawing. If the mouse is 
dragged off the easel, and then moved 
back onto the easel, drawing continues 
from the point at which the easel is 
reentered. 

Alert boxes confuse nonreaders, espe- 
cially the first few times they run a pro- 
gram. Children who can read do not 
always take the time to do it. Draw It! uses 
alert boxes sparingly. Only the EXIT op- 
tion has alert boxes that require a 
response. Even the BLANK option, which 
completely erases the screen, offers no 
warning to the user. To compensate, if a 
picture is erased unintentionally, the child 
can click UNDO and restore the picture 
(but only if no further drawing has been 
done and the page has not been 
changed). Error messages will occasion- 
ally alert the user to a problem. If the 
child clicks PRINT when no printer is 
connected to the computer, for example, 
a message will report the error accompa- 
nied by a declining scale. After a pause, 
the program will resume; no response is 
required of the user. Wliile readers may 
find the message helpful, nonreaders will 
certainly realize that something isn't work- 
ing as expected, and are likely to either 
ignore the problem or to consult an adult. 

All mouse selections are indicated in 
two ways: A box surrounds the selected 
option and a sound is heard. The box in- 
dicator is typical of adult-level paint pro- 
grams, so when the child moves on to 
more complicated programs, that feature 
will be familiar. The accompanying sound 
reinforces awareness that a selection has 
indeed been made. 

In the color version, there are multiple 
indicators of the currently selected color 
and drawing mode. The current color op- 
tion is surrounded by a box and the FILL 
and DRAW options both have indicators 
of that color. In addition, the mouse it- 
self will be that color. In both the 
monochrome and color versions, the 
mouse serves as one indicator of the 
drawing mode. It takes the shape of a 
crayon for the drawing mode and of a 
paintbrush for the filling mode. 

Young children simply cannot handle 
a file-selector box. Draw It! avoids its use 
entirely. If a picture data file exists in the 
same directory as the program, all five 
possible pictures are automatically load- 
ed and shown on the title screen. If no 
picture file is found, the title sequence 
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omits this display, and blank easels are 
presented on each of the five "pages" in 
the program. A further feature prevents 
problems during the loading sequence. 
Disks belonging to children are especial- 
ly prone to damage. One scenario I have 
seen played out again and again is as fol- 
lows: The child attempts to save his work, 
but removes the disk from the drive dur- 
ing the saving process. The filename re- 
mains on the disk, but it contains zero 
bytes. The program, when run again, at- 
tempts to load this zero-byte file. A major 
error occurs, and the program cannot 
continue. 

To avoid this. Draw It! checks the size of 
the picture tile before attempting to load 
it. If the size is not exactly what is expect- 
ed, it deletes the file from the disk. Tlie 
program then loads normally with blank 
easels, just as though there were no data 
file on the disk, and the child has an op- 
portunity to save his work properly. It's 
worth noting that you shouldn't change 
the name of some other file on your Draw 
It! disk to MDRAWIT1.DAT or 
DRAW_IT!.DAT but this would not be an 
easy task in any case: The Show Info op- 
tion on your desktop will not allow you 
to put an exclamation mark in a filename; 
the picture file has been so named in ord- 
er to prevent the easy substitution of 
other files. 

Automatic loading has an additional 
value to a young child who may not quite 
understand that when a file is deleted on 
a disk, it cannot be retrieved. When all 
the pictures on the disk are loaded with 
the program, the child must consciously 
choose to erase a picture before begin- 
ning a new drawing. If he saves his new 
work, it will not be a total shock to him 
to find that the previous work is not load- 
ed when he runs the program the next 
time. The artist is limited to five pictures 
because additional pictures would exceed 
a 520ST's memory capacity My ex- 
perience has shown, however, that five is 
a sufficient number of pictures for young 
children to work with. The process of 
drawing is much more important to them 
than the product, and, generally, they do 
not find it excruciatingly difficult to part 
with an old work when beginning a new 
one. 

One other feature makes using the 
monochrome version of Draw It! less frus- 
trating than it might have been. Most peo- 
ple who have worked with drawing 
programs have had the experience of fill- 
ing a shape and then waiting an inter- 
minable time for the filling process to be 
completed so that work can resume. Cer- 
tain fill patterns are especially likely to 
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cause problems of this kind. These pal- 
terns have been avoided. Filling with 
white fill patterns is not allowed, and only 
a white area can be filled with the avail- 
able black fill patterns. 

The options of Draw It' are purposeful- 
ly limited to reduce screen congestion. 
The options and easel share the same 
screen so that indicators of the current 
selections are continuously visible. While 
this prevents the easel from occupying a 
full screen, the ad\antages for the young 
child far outweigh the disadvantages, and 
there is still plenty of room on the ea.sel 
for the development of a picture. 



The Show It! program, also avaihiMe in 
monochrome and color versions, pro- 
vides a slide show consisting of five pic- 
tures created with Draw It! While young 
children may enjoy displaying their own 
work with a slide show. Show It! is actual- 
ly intended to involve their tiny siblings 
in computer graphics. Show It! is a slide 
show for newborn infants to two-year-old 
toddlers. Because children so young may 
have trouble clicking the mouse, keyboard 
input is used to advance die display to the 
next picture. If you have a baby in the 
house, he or she will love pressing (or 
kicking) the keys. A loud sound will bring 
the baby's attention to the monitor each 
time a key is pressed, lb exit the program, 
simply click a mouse button. If you do not 
want your toddler or infant to exit the 
progratn, remove the mouse while die 
child works with the slide show. 

My youngest son, Mickey, was born 
about the time I became reasonably profi- 
cient with DEGAS. I created for him an 
auto-booting slide-show disk consisting of 
drawings of his own familiar toys. Each toy 
was isolated on the screen against a white 
background, and the name of the toy was 
printed beside the picture ("Mr. Sailor 
Bear"). Babysitters, older siblings and dot- 
ing relatives would run the slide show for 
Mickey and read each toy name aloud as 
Mickey kicked the keyboard to display yet 
another picture. Mickey especially liked 
pictures with faces (his bear, a doll, a 
brother, etc.). This was an enjoyable ex- 
perience both for Mickey and his helper. 
One nice side effect was that the helpers 
learned to use the same names for his toys 
as 1 did, and could therefore communi- 
cate more effectively with him. Unlike tfie 
slide-show program I used, Shozvlt'has the 
advantage of producing an auditory, as 
well as a visual, response each time a key 
is pressed. Now at two years of age, Mick- 
ey is thoroughly enjoying Show It! 



Testing your printer for use 
witii Draw If! 

The monochrome version of Draw It! 
uses a command for a screen dump in 
order to print a picture. This procedure 
will provide an excellent copy of a pic ture 
from most dot-matrix printers. lo lest 
your printer's ability to accepl a screen 
dump, first make sure your printer is on, 
connected and loaded with paper Then, 
from your ST's desktop, press and hold 
the Alternate key and at the same time 
press the Help key Your printer should 
kick on and print out a picture of the 
screen. 

If the printout shows the entire screen, 
including the right edge, printouts can be 
made with MDRAW_ITPRG without 
difficulty If, however, the test printout 
omits the right edge of the screen, you 
will need to do the following: 

Copy the Control Panel accessory 
(CONTROL.ACC) that came with your ST 
onto your Draw It! disk. The Draw It! disk 
will become a boot disk for use whenever 
you work with the program. If your com- 
puter boots from a drive other than A, 
copy CONTROL.ACC to your boot disk. 

Reboot your computer with the disk in 
Drive A. When the desktop appears, pull 
down the Desk menu and click on Install 
Printer. Change the Pixels/Line setting 
from the default of 1280 to 960. Now save 
your desktop. 

Whenever you use Draw It!, reboot your 
computer from the boot disk. Your 
printer will automatically be set up to 
print a full-view screen dump. You will 
not need to change the Pixels/Line selling 
again, since that has been .saved in a 
DESKIDP.INF file on your disk. 

A problem with printouts involves the 
lef t-to-right adjustment of the picture The 
picture should be centered on the print- 
ed page and the program is designed to 
make this happen. But if your printout 
is off center, you may want to adjust the 
paper ■ — D. A. B. 
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D. A. Brumleve is involved with children 
and computers in a variety of ways. The mother 
of five children ages 2 to 10, she serves as the 
adult faulitalor of the Children's ST Users' 
Group in Vrbana, Illinois. An avid program- 
mer, she has developed a beginners' course in 
GFA BASIC and is the author of I\eSchool Kid- 
Progs (MichTron) and numerous freely- 
distributed programs for young ST users. 
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It has always been my intention, after 
we covered as many GEM programming 
topics as necessary, to present in this 
column a complete application program. 
My plans were to cover the program over 
the course of several issues, with a new 
portion being presented in each install- 
ment, and at the end of the series, put the 
pieces together to form the complete ap- 
plication. I thought that this would be the 
best way to tie together everything we've 
been discussing for the last couple of 
years. 

The problem with this idea has been 
finding the time to come up with a full- 
fledged GEM program. Such a project 
takes months of programming, and with 
my responsibilities as Executive Editor of 
ANALOG and ST-LOG, that time just hasn't 
been available to me. 

I did, however, recently finish 
MicroCheck ST, which is the perfect pro- 
gram to use as a sample GEM application. 
So, this program is going to serve us 
double-duty. It is included in this issue as 
a regular feature, and we will also use it 
in the next few months of C-manship, to 
dig into the source code and see what 
makes it tick. Virtually every GEM topic 
we've discussed in the past is put to prac- 
tical use in MicroCheck ST. 

To understand these discussions, you 
will need a good background in GEM 
programming. I won't be reviewing topics 
extensively but rather will be pointing out 
the ways in which the techniques we've 
studied are put to use in this program. 
For those of you who may have missed 
some of the C-manships, I will include, 
where appropriate, references to the past 
columns, so you'll know where to look for 
more information on a particular topic. 

The listings 

Listing 1 is the header file — created by 
the Resource Construction Set — for 
MicroCheck ST. Listing 2 is the first portion 
of the source code. In order for these list- 
ings to run properly, you need to have the 
file MICROCHK.RSC, which can be 
found on this month's disk version. For 
those of you who don't want to buy the 
disk version, I had originally planned to 
include in this month's column an ST 
BASIC program that would create this file 
for you. But due to space limitations, I was 
unable to include it at this time. I hope 
to supply that listing next month. 

For those of you who do have this 



month's disk, the portions of MicroCheck 
ST included here in Listings 1 and 2 will 
compile and link with no problems, even 
though they aren't the complete program. 
Be forewarned, though, that when you 
run the program created from these list- 
ings, the only way to get out of it is to re- 
boot your computer. The portion of 
MicroCheck ST that includes the Quit func- 
tion is not presented this month. 

Note: Some of the lines in Listing 2 end 
with a tilde (-). The tilde means that the 
line "wraps around" onto the next line of 
the listing. The two lines should be typed 
as one, leaving out the tilde. 

The discussion 

As I said above. Listing 1 is a file that 
was created by the Resource Construction 
Set. It contains nothing more than a ser- 
ies of *defines that equate the object and 
tree ID numbers of our resource with 
names that are easier to remember and 
that make for better reading code (see the 
April '87 C-manship). There's not much to 
say about this listing, except that you'll see 
every name there used somewhere in the 
MicroCheck ST source code (though not 
necessarily in the portion being present- 
ed this month). 

Listing 2 is a small section of the 
MicroCheck ST source code. It is only about 
Va of the full program, which gives you 
some idea of how large a full-GEM appli- 
cation may be. Although GEM is a great 
boon to the end user, whatever con- 
veniences he gets are passed on to the 
programmer as extra work. A large por- 
tion of a GEM program deals with han- 
dling GEM rather than getting down to 
the business of the application itself Set- 
ting up and handling dialog boxes, win- 
dows and menu bars takes many lines of 
code. 

At the very top of the listing we have 
some *includes, which tell the compiler to 
add these files into our program at com- 
pilation time. We've discussed these files 
before. Note that the MICROCHK.H file 
is also included here. 

Below the ^includes we define some 
constants of our own. Just as we saw with 
the MICROCHK.H file, anytime we can 
replace a number, which tends to be cryp- 
tic, with a name, we'll be making our 
programming task easier and our resul- 
tant code more readable. Which makes 
the most sense to you: OXIEOI or 
CNTL-A? 



Below that we have the usual GEM 
global arrays. Every GEM application has 
to provide these storage areas. 

Next we declare some of our variables. 
The array msg_buf [ ] will be used to store 
messages sent to us by GEM. The array 
pivrs [] IS used in a conversion function 
not shown in this month's listing. There's 
also a long list of integers and character 
arrays. I won't spend a lot of time now ex- 
plaining what each one is. We'll talk about 
them as they appear in the listings each 
month. If you look through the list of in- 
tegers being declared, though, you'll see 
a lot of variable names you've run across 
before — variables that are needed to han- 
dle GEM's many functions. 

Take a look at the pointers of type OB- 
JECT declared below the character strings. 
If you've been following C-manship close- 
ly and keeping up on your studies, you'll 
know that these pointers will contain the 
addresses of each of the trees that make 
up our full resource tree (see the May '87 
C-manship). 

A little further down, you'll see a struc- 
ture named check. This structure has 
storage areas for each piece of data we 
need for a checking account transaction: 
the check number, the payee, a memo 
field, the date the check was written, the 
amount of the check, and a field to indi- 
cate if the check has been cancelled 
(processed by the bank). 

Of course, a checking program that'll 
hold enough data for only one check is 
useless. That's why our next step in set- 
ting up our data is to create an array of 
these structures — the arrays named checks 

[] and srch checks []. The former will 

hold all the transactions for a particular 
month and the latter will hold all the 
transactions that match the search criteri- 
on when a search of the account is per- 
formed. The pointer *cur chk-strc, will be 

used to keep track of which of the two 
check structures we're currently using. 

Finally, the last item declared before 
the program begins is the pointer 

*ob tedinfo, which is a pointer to a 

TEDINFO structure. Hopefully, you'll 
remember that a TEDINFO structure is 
used to hold the information we need for 
an editable text field in a dialog box (see 
the May '87 C-manship). 

Function mam( ) 

Every program is made up of three 
main sections: initialization, the program 
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itself and the job-end section (cleanup). 
The function main() breaks these three 
sections into six easy-to-follow steps. The 

functions appl init( ) and open vwork( ) 

initialize our GEM application (not the 
program, mind you, just GEM). The func- 
tion do mchecki ) is the controlling func- 
tion for MicroCheck 57^where main( ) 
handles the three sections of setting up 

the GEM operating system, rfo mcheck 

does the same for our actual program. Fi- 
nally, the functions v clsvwk( ), Setcolor( ) 

and appl exit( ) perform the job-end 

duties, closing down our workstation and 
returning the GEM desktop to the same 
condition it was when we left it. 

Function d0__mehe€k ( ) 

The function do mcheck( ) begins by 

setting the ST's colors the way we want 
them and checking to see if the user has 
run the program in the proper resolu- 
tion. If the resolution is okay, we set the 
mouse to an arrow and initialize some 
strings and variables. Then we get the sys- 
tem date with a call to get_date( ). 

The next step in our program initiali- 
zation is to load the resource file and get 
the addresses of each of the trees that 
make up the resource First, we check to 
see that the file MICROCHK.RSC is on 
the disk. (It must be in the same directo- 
ry as the main program.) If it's not, we 
warn the user of the error and return to 
the desktop. If the resource file is availa- 
ble, we load it and get the addresses of 
each of the trees. Remember that each of 
these trees makes up one of the GEM 
forms — such as a dialog box or menu 
bar — that we will be using to get data to 
and from the user. 

After we load the resource file, we bring 
up the menu bar with a call to 

menu bar() and set the entries in the 

menus appropriately with a call to 
set menu_entries( ). 

Now all we have to do is set up our win- 
dows, and we're all set (see the July/August 
'87 C-manship). In MicroCheck ST, there are 
actually two windows in use, although 
only one of them is visible. The invisible 
window has no parts (sliders, arrows, etc.) 
and covers the entire screen area. I use 
it to get redraw messages for portions of 
the screen that are not covered by the visi- 
ble window. 

After we set up the windows, we send 
program execution to the function 

get event( ), which routes the events our 

application receives from the user to the 
proper sections of the program. 

Eventually, the user will indicate that he 
wishes to quit the program. When he 



does, the last portion of do mcheck( ) re- 
moves the menu bar, closes and deletes 
the two windows, and returns the memory 
used by our resource tree back to the sys- 
tem. (Remember: this month's program 
segment doesn't let you quit.) 

Function get_0ven§( ) 

As you should already know, a GEM ap- 
plication program receives its instructions 
from the user by way of "events." There 
are many types of events, handling not 
only GEM constructions such as windows, 
menu bars and dialog boxes, but also the 
mouse and the keyboard. In MicroCheck ST 
we are interested in three main types of 
events: keyboard, mouse and GEM mes- 
sage events. 

If you take a look at the function 

get event( ) in Listing 2, you'll see that it 

takes only a small amount of source code 
to retrieve and route the events. Basical- 
ly, all we have to do is get the event, figure 
out what type it is and pass it on. 

To get the events, we use the unwieldy 

and complicated function evnt multi( ) 

(see the June '87 C-manship). The integer 
event will hold the event number, which 
we'll test in three different statements, 
each of which will route its event to the 
proper function. 

The three functions, handle_key( ), 

handle messages( ) and handle_button( ), 

process keyboard, message and mouse- 
button events, respectively. Notice that, at 
the end of Listing 1, these functions are 
represented by "stubs"; that is, functions 
that do nothing except provide a label for 
the linker. Without these stubs, you would 
not be able to link the program success- 
fully. (The actual functions will be 
presented next month.) 

Function set__menu_entries( ) 

The function set menu entries( ) in 

Listing I disables any entries in the menu 
bar that we don't want the user to have 
access to (see the June '87 C-manship). For 
example, until an account has been load- 
ed, it's not possible to perform a search 
on the checks in the account. Rather than 
having to give the user an error message 
when he clicks on the Search option, we 
just make the option unavailable to him. 

The function set menu entries( ) is only 

one of three functions in MicroCheck ST 
that enable and disable menu options 
based on the program's current mode. 

Functions €al€_vslid( ) 
and €aU__hsHd( ) 

The functions calc vslid( ) and 

calc hslid( ) set the sizes and positions of 



the window's vertical and horizontal 
sliders (see the May '88 C-manship). This 
can be a confusing process, but one that 
is essential to the proper handling of win- 
dows. Assuming you understand how the 
sliders work, the only thing worth noting 
in these functions is found in calc^Jislid{ ), 
where the flag left is used to determine the 
position of the horizontal slider. This 
method is used because this slider can be 
in only one of two positions — all the way 
to the left or all the way to the right. 

Function open_vwork 

Now we come to a function that C- 
manship readers have seen dozens of 
times, open_vwork( ). Anyone who doesn't 
know that this function sets up a virtual 
workstation, a necessity for a GEM appli- 
cation, should go back to square one and 
do some heavy reviewing. 

Function ge§^date( ) 

Finally, the last function presented this 

month, get date(), is responsible for 

retrieving and formatting the date from 
the ST's clock (see the September '88 C- 
manship). In this function, we're setting up 

two different strings, date but[ ] and 

cur date( ). The former will be in the for- 
mat mm/dd/yy and will be displayed in a 
date button at the bottom of the screen. 
The latter will be in the format mmddyy 
and will be used as the default date for 
the check-entry dialog box. 

Final notes 

When you run this segment of 
MicroCheck ST, you'll find on the screen a 
halfworking menu bar and a window 
with a blank work area. In addition, the 
information buttons that are normally 
displayed at the bottom of the screen (see 
the illustrations accompanying the 
MicroCheck ST article in this issue) will be 
missing. This is normal and has to do with 
the fact that this portion of the program 
is not set up yet to process GEM message 
events. 

In closing, I would strongly urge those 
of you who wish to follow this in-depth 
look at a GEM application program to 
purchase this month's STTLOG disk version. 
The complete MicroCheck ST can be found 
there, and I believe that it will help you 
better understand our discussions if 
you're familiar with the program. I will, 
however, try to make these columns as 
"freestanding" as possible, so that those 
who do not wish to purchase the disk will 
be able to follow along. 

Next time, we'll look at another chunk 
of MicroCheck ST. m 
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/* 


OBJECT 


in 


TREE 


tt4 


»/ 


ttdel 


ine 


RECCHKS 5 


/* 


OBJECT 


i n 


TREE 


»8 


»/ 


tt d 9 1 


1 n e 


QprMrNPi 4 

OnLrnLrnLrL t 


/» 


OBJECT 


in 


TREE 


tt4 


*/ 


ttdel 


ine 


RECDEPS 10 


/» 


OBJECT 


in 


TREE 


tt8 


*/ 


tt del 


1 ne 


NFUMAMF 9 

ntMnHnc. Z 


/» 


OBJECT 


in 


TREE 


ttO 


»/ 


ttdel 


ine 


RECBALSH 13 


/* 


OBJECT 


in 


TREE 


»8 


»/ 


tt d e 1 


1 n 9 


n tHH U Un o 


/« 


OBJECT 


in 


TREE 


ttO 


*/ 


ttdel 


ine 


RECOUTCH 4 


/* 


OBJECT 


in 


TREE 


tt8 


»/ 


tt d e ' 


1 ne 


M FLIP I TV A 
n LHU III 1 


/« 


OBJECT 


in 


TREE 


ttO 


»/ 


ttdel 


ine 


RECOUTDP 9 


/* 


OBJECT 


in 


TREE 


ttB 


«/ 


** A n 4 
tt 09 


i ne 


IIFIICTATF 
n tHo 1 R 1 t 3 


/* 


OBJECT 


in 


TREE 


ttO 


«/ 


ttdel 


ine 


RECBALIS 15 


/* 


OBJECT 


in 


TREE 


tt8 


»/ 


ttd9' 


i ne 


y CI 1 7 T D c 


/» 


OBJECT 


in 


TREE 


ttO 


»/ 


ttdel 


ine 


RECDIF 18 


/* 


OBJECT 


in 


TREE 


tt8 


*/ 


ttd9 


i ne 


U CI 1 D A 1 UP 7 


/» 


OBJECT 


in 


TREE 


ttO 


«/ 


ttdel 


ine 


RECOK 19 


/* 


OBJECT 


in 


TREE 


tt8 


*/ 


ltde 


^ i ne 


nn 1 Hr Kun < 


/* 


OBJECT 


in 


TREE 


tt4 


*/ 


ttdel 


ine 


LKMNDIAL 9 


/* 


TREE »/ 










ttd9 


i ne 


M u T u T rt o 
nn 1 H I U o 


/» 


OBJECT 


in 


TREE 


tt4 


»/ 


ttdel 


ine 


SCANMNTH 2 


/» 


OBJECT 


in 


TREE 


tt9 


»/ 


ttde 


i n9 


U 1 IM c □ nM Q 

nUnrKUn 7 


/» 


OBJECT 


in 


TREE 


tt4 


»/ 


ttdel 


ine 


CHKAUTO 30 


/» 


OBJECT 


in 


TREE 


ttl 


*/ 


ttde 


i ne 


u 1 IM T n in 
nun 1 U It] 


/* 


OBJECT 


in 


TREE 


tt4 


*/ 


ttdel 


ine 


NEUMNTH 24 


/» 


OBJECT 


in 


TREE 


ttl 


»/ 


ttde 


ine 


AMHTFROM 11 


/* 


OBJECT 


i n 


TREE 


tt4 


*/ 


ttdel 


ine 


PAID 12 




OBJECT 


in 


TREE 


tt7 


«/ 


ttde 


■ ine 


AMNTTO 12 


/» 


OBJECT 


in 


TREE 


tt4 


*/ 


ttdel 


ine 


IMPORT 37 


/» 


OBJECT 


in 


TREE 


ttl 


«/ 


ttde 


■ i ne 


PAVEFROM 13 


/» 


OBJECT 


in 


TREE 


tt4 


»/ 


ttdel 


ine 


SRTODIAL 10 


/» 


TREE */ 








ttde 


■ ine 


MEMOFROM 14 


/» 


OBJECT 


in 


TREE 


tt4 


»/ 


ttdef 


ine 


DBCNT 3 


/» 


OBJECT 


in 


TREE 


ttlO */ 


ttd9 


■ ine 


CHKCAN 29 


/* 


OBJECT 


in 


TREE 


ttl 


»/ 


ttdel 


ine 


DBTOT 5 


/* 


OBJECT 


in 


TREE 


ttlO «/ 


ttde 


■ ine 


CANCDIAL 5 


/» 


TREE */ 








ttdel 


ine 


CRCNT 7 


/* 


OBJECT 


in 


TREE 


ttlO */ 


ttde 


■ ine 


CANCOK 3 


/» 


OBJECT 


in 


TREE 


tt5 


*/ 


ttdef 


ine 


CRTOT 9 


/* 


OBJECT 


in 


TREE 


ttlO */ 


ttde 


in9 


CAHCCANC 4 


/» 


OBJECT 


in 


TREE 


Its 


«/ 


ttdei 


ine 


SRTOOK 16 


/* 


OBJECT 


in 


TREE 


ttlO */ 



C-MANSHIP 
Listing 2: C 



/ MMKKMICIIKIIXMKMKMMMICimiillimmiKMMMICimMKimMMMmCliKMKMKMICXKMKKMKXmi 

» niCROCHECK ST * 

« by Clayton Ualnun * 

* * 

* Copyright 1989 by ST-LOG * 

* Developed with Laser C » 

KlIMlCMliKliMMMIiKiiKMKMKMmiMMmiMimMMKMmmiCMKWmimtmdmMKMICMIClCMICMKII / 

Kinclude <st(jio.h> 
ninclude <osbind.h> 
Itinclude <9endefs.h> 
ttinclude <obdefs.h> 
Itinclude <fcntl.h> 
ttinclude "nicrochk.h" 



ttdef ine MA.UPPAGE 
ttdef ine MA.DNPAGE 
ttdefine MA.UPLINE 
ndefine MA-DNLINE 
ttdefine MA_LFPAGE 
ttdefine MA-RTPAGE 
ttdefine BOLD 
ttdefine LIGHT 
ttdefine TRUE 
ndefine FALSE 
ttdefine VES 
ttdefine NO 
ttdefine LEFT-BUTTON 
ndefine BUTTON-DOMN 
ndefine NUM.CLICKS 
ndefine PARTS 
ndefine NUM.COLUMNS 
ndefine MED 



1 
2 
3 
4 

S 
1 
2 
1 

e 
1 

2 

Bxeeei 

exBOBl 
2 

NAME jlNFO I UPARROM I DNARROM I USLIDE | FULLER | CLOSER I HSL IDE 

93 

1 
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C - M A N S H I P 



ft 





ndef ine 
ltdef ine 
ttdef i ne 
ltdef i ne 
ltdef i ne 
ttdef ine 
tldef ine 
ttdef ine 
ltdef ine 
ltdef ine 
ttdef ine 
ttdef ine 
ttdef i ne 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 
ttdef ine 



MATCH \ 

REC-LENGTH 

FROM_BEG 

FROM_CUR_POS 

FAILED 

DFLT-DRU 

UISIBLE 

MEDIUM 

HIGH 

CHAR-AUAIL 

COHSOLE 

ESCAPE 

CNTL_A 

CNTL_B 

CHTL_C 

CNTL_D 

CNTL_E 

CHTUG 

CHTL-I 

CNTL_M 

CHTL_H 

CMTL_0 

CNTL_P 

CNTL_Q 

CHTL_R 

CNTL-S 

CNTL_M 

CHTL_V 



117 

e 

1 

t-iJ 
8 
1 
1 

2 

-1 
2 

27 

OxleBl 
6x3882 
ex2ee3 
8x2804 
8x1285 
8x2287 
8x1789 
8x328d 
ex318e 
OxlBBf 
8x1918 
8x1811 
8x1312 
8xlf 13 
8x1117 
8x1519 



int work_in[ll]j uork_out [573 , contrI[12], 

intin[128], ptsin[128], intout[128], ptsout[1281; 

int nsg-buf [8] ; 

long pwrstl = { 1, 18, 180, 1888, 10808, 188088, 1888800, 10808800 }; 

int handle, dun, file, key, 

fullx, fully, fullw, fullh, urkx, wrky, wrkv/, urkh, 
w_hl, w.h2, res, full, nun_trans, charw, charh, curchknun, 
nun-deps, nun_chks, loaded, all-done, nouse_x, nouse_y, 
nun_clicks, edit_top, left, start_nnth, end_nnth, nnth, srch_trans, 
start_nun, end-nun, cur_count, cur_top, search, saved, canceling, 
nonth, full-draw, oldcolr! 

int zero = 0; 

char f ilenane[64], chknane[38], chkstreet [381 , chkcitalSBl, 
date-but [181, bal-but[18], trans-but[4], 
check-but[4], dep_but[4], nnth-but [10] , acct-nane [64] , 
nonthf i le [64] , c ur-c hk-nun [6] , cur-date[7], f uture-use[40] , 
cancnnth[S], chtot[20], dptot[20], chcnt[10], dpcnt[10]; 

char windnane[64] ; 

char noacct[] = "Mo account opert'-d") 



char canc[] 
char newn[] 



"CANCEL CHECKS" 
" NEU MONTH " 



char KnonthsC] = I "Month 8", "Januarg", "February" 
"May", "June", "July", "August", 
"Novenber", "Decenber" >; 



"March", "April", 
"Septenber", "October" 



char spaces[] = 
char infotextl] 



Nunber 



char wstring, »srch-payee, 
char rule[] = " 



Anount 
Date"; 
»srch_neno; 



Payee 



long balance, start-annt, end-annt; 

OBJECT «nenu-addr, «check-addr, »neuacct-addr, »ne«f ile-addr, 

»newdate_addr, «srchdial-addr, «cancdial-addr, «recndial-addr, 
«rprtdial-addr, «lknndial_addr, «srtodial-addr; 

FILE Kacctfile, «nfilei 

char «get-tedinf o-str C3 ; 
FILE )(opn-nw-auto t) ; 
long str-to-long C) ; 

struct check { 
char nunber [5] J 
char payee [31]; 
char neno [31] ; 
char date [9]; 
long anount; 
char cancel[2]; 



struct check checks[568]; 
struct check srch-checks [1888] ; 
struct check »cur-chk_strc ; 

TEDINFO Mob-tedinfo; 



nam 



appl-init C] ; 
open-vwork C3 ; 
do_ncheck () ; 
v_clsvwk [handle); 
Setcolor ( 2, oldcolr ]; 
appl-exit () ; 



/» Initialize application. »/ 

/« Set up workstation. »/ 

/* Go do MicroCheck. */ 

/* Close virtual workstation. */ 

/» Reset color register. »/ 

/* Back to the desktop. */ 



do-ncheck [) 
{ 

oldcolr = Setcolor C 2, -1 ] ; 
Setcolor ( 2, 8x885 1; 

if C (res = Getrez () 1 >= HIGH SS res != MEDIUM ) 

forn-alert[l, "[8] [MicroCheck ST runslonly in high or nediun jresoluti'^ 
on.] [OK]"); 
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else I 

graf -MDUse ( ARROU, Sdun ) ; 
strcpy C acct_nane, "NONE" ): 
stpcpu C cur_chk_nun, "OBBO" ]; 
balance - 6; 
nonth : -1; 

ed it-top = cur-top = nun-trans = nun-chks 
left = saved = TRUE; 

search = canceling = full-draw = FALSE; 
cur_chk-strc = checks; 
get-date (} ; 



nun-deps = 0; 



SMICROCHK.RSC" J J 
"[1] [MICROCHK.RSC nissing ! ] [Okay] 



if C !rsrc_load ( 
forn_alert ( 1 
else { 

rsrc_gaddr t R_TREE, MENUBAR, £nenu_addr ) 
rsrc_gaddr ( R-TREE, CHEKDIAL, «check_addr J 



rsrc_gaddr ( R_TREE, 



rsrc-gaddr 
rsrc-gaddr 
rsrc-gaddr 
rsrc_gaddr 
rsrc_gaddr 
rsrC-gaddr 
rsrc_gaddr 
rsrc-gaddr 
nenu_bar C 



NEMADIAL, 
FILEDIAL, 
DATEDIAL, 
SRCHDIAL, 
CANCDIAL, 



&newacct_addr ); 
Sneuf i le_addr ) ; 
&neudate-addr ]; 
&srchdial-addr ]; 
&cancdial_addr 3; 



RECNDIAL, Srecndial-addr ); 
RPRTDIAL, Srprtdial-addr ); 



R_TREE, 
R_TREE, 
R_TREE, 
R_TREE, 
R_TREE, 
R_TREE, 

R-TREE, LKHNDIAL, Slknndial_addr ]; 
R_TREE, SRTODIAL, Ssrtodial_addr ); 
nenu-addr, TRUE ) ; 
set-nenu-entries C); 

uind-get ( B, UF-MORKXVUH, Sfullx, Sfully, SfuUu, Sfullh ); 
w-hl = wind-create C 6, fulix, fully, fuUw, fullh ]; 
w-h2 - wind-create t PARTS, fullx, fully, fullw, fullh 3; 
wind-set ( w-h2, UF-NAME, noacct, B, 0 ); 
wind-set ( w-h2, UF-INFO, infotext, B, 6 ) ; 
wind-open ( w-hl, fullx, fully, fullw, 
wind-open C w-h2, fullx, fully, fullw, 
calc-vslid C 1 ); 
calc-hslid ( NUM-COLUMNS ); 
full = FALSE; 
loaded - FALSE; 



fullh ]; 

316 - 162«tres= 



:HED] ]; 



get-event C) ; 

nenu-bar C nenu-addr, 
wind-close ( w-h2 ); 
wind-delete C w-h2 ]; 
wind-Close C w-hl ); 
wind-delete C w-hl 3; 
rsrc-free () ; 



FALSE ); 



get-event (I 

C 

int h, event; 
all-done = FALSE; 



ile C lall-doni 
event = evnt. 



-nVjlti t HU-KEVBD|MU_MESAG|MU_BUTTON, NUN_CLICKS, 
LEFT_BUTTOH, BUTTON-DOWN, 

8, e, a, e, nsg_buf, e, e, 

&nouse_x, &nouse.y, &dun, &dun, &key, &nun_c licks J J 



if C event & NU-KEVBD 3 
handle-keys C) i 

if t event & t1U_MESAG ) 
handle_nessages C) l 

if C event & MU-BUTTON } 
handle.button (} ; 





set_nenu. 
{ 

nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
) 



.entries CJ 



ienable 

ienable 

ienable 

ienable 

ienable ( 

ienable C 

ienable 

ienable 

ienable 

ienable 

ienable 

ienable 

ienable 

ienable 

ienable 



nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 
nenu. 



.addr, CLOSEHBR, loaded J; 

.addr, OPENMBR, ! loaded J; 

.addr, NEMACCNT, ! loaded 3; 

.addr, QUIT, TRUE 3; 

.addr, ENTER, loaded J; 

.addr, SEARCH, loaded )J 

.addr, CHKCAN, loaded ); 

.addr, NENMNTH, loaded ); 

.addr, RECONCIL, loaded 3; 

-addr, PRNTMIND, loaded 3; 

.addr, PRNTREG, loaded 3; 

.addr, NEUVEAR, ■ loaded 3; 

.addr, CHKAUTO, loaded ); 

.addr, NEUDATE, TRUE 3; 

.addr, IMPORT, 'loaded 3; 



calc-vslid C line.cnt 3 

int line_cnt; 

{ 

int lines-avail, vslid-siz. 



pos; 



wind-get C w_h2, UF.UORKXVNH, &wrkx, &urkg, &wrkw, &wrkh ); 

lines_avail = wrkh / charh; 

vslid-siz = 1000 « lines_avail / line_cnt# 

wind_set ( u-h2. WF_USLSI2E, vslid_siz, 8, 0. 8 3; 

pos = (int3 C tf loat3 Ccur_top3 ) / 

C Cf loat3 Cline-cnt - lines_avain 3 k 1000; 
wind_set C M_h2, WF_USLIDE, pos, Q, 1 0 3; 



calc-hslid ( col-cnt ) 

int col_cnt; 

{ 
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int cols_availj hslid_sizj pos, 1ft; 

if ( I«ft ) 
1ft = e; 



wind-get C w-h2, UF-UORKXVUH, Surkx, Surky, Swrkw, Swrkh ); 
cols_avail = wrku / charw; 

hslid-siz = (int) CCieeeL » (lo'ig) cols-avail) / Clong) col.cnt] ; 
wind-set ( w-h2, UF-HSLSIZE, h<.lid-siz, 6, 6, 6 )i 

pos = (int) ( (float) (1ft) ) / ( (float) (col.cnt - cals_avail) ) » 1606: 
wind-set ( w_h2, UF-HSLIDE, pos, 6, 6, 6 ); 



/ open_vwork () 

int i; 



handle = graf-handle ( Scharw, ScharH, Sdun, Sdun); 
for ( i=8; i<18; work_ln[i++] = 1 )) 
work-inCiei = 2; 

v_opnvwk ( work-in, &handle, work-out ); 



get-date () 
C 

int date, day, nnth, year; 
char d[3], n[3], y[4]; 

date = Tgetdate () i 
day - date & 8xeeif; 
nnth = (date >> S) < Bxeeef; 
year = ((date >> 9) t exee7f) * 86; 
year = year r. 166; 
sprintf ( d, "xd", 
sprintf ( n, "xd", 
sprintf ( y, "Xd", 
if ( nnth < 16 ) ( 

date-butCei = '8'; 

cur-date[6] = '8'; 

strcpy ( &date-but (1) , n 

strcpy ( Scur-dateEl], n 

} 

else C 

strcpy ( date-but, n ); 
strcpy ( cur-date, n ); 

) 

date-but [21 = V; 
if ( day < 16 ) { 

date-but[3] = '6'; 

cur-date[2] = '8'; 

strcpy ( Sdate-but[4], d 

strcpy ( Acur-date [3] , d 

} 

else { 

strcpy ( Sdate-but[3], d 
( Scur-date[2], d 



day ); 
nnth ); 
year ) ; 



C-manship 



strcpy 

) 

date-but [51 = V; 
if ( year < 18 } { 

date_but[6] = '8'; 

cur-date[4] = '8'; 

strcpy ( &date-but[7], 

strcpy ( tcur_date[S], 

) 

else C 

strcpy ( Sdate-butCG), 
strcpy ( &cur-date [4] , 

} 



handle-keys () 
O 

handle-nessages () 
C) 

handle-button () 

C) 




END 




Turn Your Atari 
into a Macintosh™ 



The Newest, Most Powerful Macintosh 
Emulator Available for Atari Computers 

COMPATIBILITY: 

• Reads and Writes Macintosh format disks with your 
Atari ESsk Drive 

• Runs the latest Mac Software like HyperCard™ 

• Uses Spectre Format or Mac Format Disks 

• Requires 128K Mac Roms and an Atari Computer 

• Hard CKsk Compatible 

SPEED: 

• GCR allows you to "plug and play" 
with Macintosh Disks; no need to 
copy Mac disks to Spectre disks 

• Screen 30% larger and overall 
speed is 20% faster than Mac Plus 

Suggested Retail : $ 299.95 
Available June 1989 

40 W. Littleton Blvd., #210-211 • LitUeton, Co. 80120 

MKinUHli. Mic, ad HypaCnd an tndoDuki (tf Apple CanpuM, be. 

CIRCLE #108 Oil READER SERVICE CARD. 
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Is computer art really "art" in the tradi- 
tional sense? That's a tough question. It's 
hard to define computer art, because it 
lacks solidity. After all, it's not really any- 
where in a form commonly accepted in 
auctions. Even in a display it's only a tran- 
sient visitor to a few RAM chips. And 
printed — well, what printer can capture 
all of the details of a screen? 

Computer art certainly demands all of 
the same skills, learning, effort and talent 
of other art. But unlike all the rest of 
them, it has no permanent existence. On 
disk, it's merely a collection of magne- 
tized oxide particles, prey to whatever cos- 
mic mishap befalls disk data. Even if it 
remains stable, it is still more subject to 
change than any other form of art, since 
a single-bit adjustment creates a new 
piece. And since it's copyable, there is no 
such thing as an "original" as befits a 
great painter. Signed bitware, unchange- 
able artistic masters on disk? Not yet, any- 
way Until then, "computer art" remains 
more of a ci"aft than an art. 

I'm no great shakes as an artist. Every- 
thing I draw seems to come out cockeyed. 
It's even worse with software. Doesn't mat- 
ter what the drawing tool is or how many 
amazing features there are either I under- 
stand art quite well: the process, perspec- 
tive, viewpoint, the mechanics, all of that. 
It just doesn't translate itself well onto 
paper (or scrcer>) for me. 

However, that doesn't spoil my fun. Like 
most folks, I doodle, and given a com- 
puter paint program, I do it electronical- 
ly. I've met others who do this quite 
proficiently and can whip up some rather 
impressive screens. The polite term for 
their work is "art," but I don't think the 
electronic Etch-A-Sketch stuff I produce 
deserves the distinction. I never managed 
to enchant any lady up to my gaiTet to see 
my computer etchings, either — Susan v«ts 
far too canny to fall for that line. 

Part of my excuse for poor artistic per- 
formance may be valid for a lot of peo- 
ple with a higher level of talent, but who 
experience difficulty with computer draw- 
ing: The primary tool is inadequate, not 
the software, the mouse. I can do much 
better with a light pen and even produce 
something passably attractive with a 
digitizing tablet. But the mouse seems 
particularly unsuited for fine, freehand 
drawing. Maybe it's because it doesn't feel 
like a pen or a brush — or any of the ver- 
tically held tools we're taught to use. Or 
maybe it's because most mice have their 
rolling ball (which represents the pointer 
location as well) below the palm of your 
hand, rather than at the fingertips, where 
a pen or brush works. 




B Y 
I A N 

C H A D W I C K 



Ever try to sketch something with a 
mouse? My dog could do better holding 
a crayon in his teeth! It sometimes seems 
that whatever I draw looks, at first, like a 
child's crude efforts. In order to compen- 
sate for the clumsiness of the mouse, I 
have to depend on software features such 
as zoom-level tools to correct straying 
lines and clean up nasty clumps of pix- 
els; curve tools (Bezier and b-spline) to 
make lines look less like snail trails; line, 
ellipse, frame and so on for polygons. In 
art software, the more features, the bet- 
ter I like the program. 

There are two sorts of art programs 
around: draw and paint. This column's 
about the latter; I'll do draw programs 
some other time. Basically the difference 



(Iv file Edit Facilities Filters Ptripherils 



»i 751 yi 62i 




LAZY 



llcsli File »lw Hit nil text 

I Z~. .V \TliM Jli\S»tlPLi , IKe\SIIiNIIICt . IHO 




TOUCH-UP 



is that draw programs deal in "objects" 
and vectors (as most CAD programs do) 
and paint programs deal in pixels and 
screens. There is some overlap in func- 
tionality and features, but not enough for 
my taste. 

MacPaint is the archetypal paint pro- 
gram from which many ST paint pro- 
grams derive (as well as many PC paint 
programs). In it several important ideas 
were developed, as well as many icons, fea- 
tures and styles that are today accepted 
as standards. 

DEGAS, one of the first such ST pro- 
grams, and still one of the best, owes only 
some of its lineage to MacPaint. Author 
Tom Hudson took his own course, espe- 
cially with DEGAS Elite. He prefers the 
dual command-screen/drawing-screen 
mode rather than putting all of his tools 
in the one screen with the work area, but 
the basic tools are the same However, DE- 
GAS is a bit long in the tooth these days 
and suffers from three main weaknesses: 
the rigid picture size (always exactly one 
screen large), the lack of curve and spline 
tools and the inability to cut non- 
rectangular blocks. These could be reme- 
died, along with the addition of new tools 
and features, to bring DEGAS Elite back 
to the fore, but I personally don't believe 
Electronic Arts has sufficient interest in 
the ST market to make such a com- 
mitment. 

I remember when I was working on the 
manual for DEGAS, back in the ST's 
Paleozoic. While learning the features, I 
spent hours and hours working on a 
"painting" of a vrasp — lots of (for me, any- 
way) detail meticulously transcribed from 
a photograph, background scenery lov- 
ingly added in at zoom level. I was so 
proud of it that I offered it to Batteries 
Included (BI), the company that originally 
inarketed DEGAS, to include on their disk 
as a sample picture, free of charge. 

Some hope. Marty Herzog of BI smiled 
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condescendingly and showed me some of 
the samples they already had from peo- 
ple with what appeared to be an endless 
reservoir of talent in that area. As I 
watched the slide show of t heir efforts, my 
wasp became flat, uninviting, lifeless. I 
heaved a great sigh and went back to the 
writing, leaving the art to those who do 
it best. 

So what? Well, being an artist is one of 
those hidden dreams that lurks deep in- 
side me. Despite a propensity for draw- 
ing stick men and a sense of perspective 
only an alien could appreciate, I love to 
draw. Inside me lurks the heart of Picas- 
so, Rembrandt, Da Vinci. That's why I can 
never avoid the lure of new art 
programs — in this case HyperPaint from 
Atari UK, Touch-Up from Migraph and two 
from Human Technologies in France: 
iMzy Paint and Rough. A real internation- 
al sampling. 

HyperPaint one might call Atari UK's an- 
swer to DEGAS. It is a competent paint 
program that adds a few features and en- 
hancements to DEGAS but not everything 
that is needed. It supports GDOS and the 
manual has a rather good description of 
GDOS, ASSIGN.SYS and the installation 
process. 

HyperPaint has Bezier curves, save/load 
.IMG files, ten workscreens (each of which 
can have its own palette), irregular block 
cut/copy/paste and a few other features, as 
well as the standard draw/paint/fill func- 
tions we know and expect. The interface 
is a little jagged and at times awkward. For 
example, if you choose Quit or click on 
the close box, you can choose to save the 
current workscreen (only!) or quit, but not 
cancel. It's an easy way to lose a lot of 
work. Also, you don't print from within 
the program — you do so through a 
separate output program, from which you 
can load or print a file. 

Atari UK failed to provide any sample 
pictures in any format, a weakness for 
new users who'd rather tinker with pre- 
drawn work than attempt their own 
masterpieces before mastering the pro- 
gram. Facing a sparsity of paint programs, 
HyperPaint would be high on my list. But 
with so many others around — even some 
darn good public domain offerings — it 
doesn't offer enough novelty to recom- 
mend. It needs more chrome, more shine. 

Touch-Up and Lazy Paint (which I believe 
is also known as ZZ Paint) are mono- 
chrome paint programs. This is unusual 
in itself: Publishers have tended to focus 
on the ST's color abilities and have treat- 
ed mcjnochrome as a poor cousin. P^int 
programs that have worked in mono have 
simply done the same things they do in 
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color, without regard to any of the spe- 
cial needs and abilities of black and white. 
Touch-Up also works on a color monitor, 
in low and medium resolution, but only 
provides black and white "colors." Lazy 
Paint works strictly in mono. 

Monochrome, by the way, isn't simply 
trading colors for higher resolution. It's 
a different metaphor completely. It's like 
the movies. A lot of movies shot in black- 
and white were so done because no one 
had color technology. On the other hand, 
a lot of directors chose black and white as 
their medium, despite the availability of 
color, because it offers special effects un- 
attainable in color, and it also requires a 
different type of craftsmanship. 
Monochrome art is like that: to novices 
it looks like it offers less. But even if it's 
a lot more demanding, the results can be 
more satisfying. 

In monochrome, it's much easier to do 
grey-scale gradations, and this should be 
an integral function in any mono-paint 
program. Many color paint programs pro- 
vide a similar feature that permits auto- 
matic gradation or shifts, so it's 
reasonable to expect the same thing in 
mono-paint programs. If not done in ac- 
tual grey scales, then it should be possi- 
ble through patterns. 

Towh-Up is one of those "Ferrari" pro- 
grams: oodles of chrome, features and 
functions to complement the usual lot of 
commands. One example is the "map to 
black" option that translates color pic- 
tures to monochrome. Simple enough 
idea, except that Touch-Up offers six 




methods of mapping, with variations. Mi- 
graph doesn't do anything by halves. 
Other extra features include B-spline and 
Bezier curves (with nice B-spline 
parameter settings); a .IMG file viewer; 
.TIFF format support; a dynamic screen 
locator in zoom mode; measurements in 
inches; centimeters or pixels; fill patterns 
in 75, 150 and 300 dpi; GDOS support; 
many, many text, clip and display options; 
plus a whole lot more. A lot of thought 
went into this program. 

There are some problems with Touch- 
Up however. One is the manual: First, it 
has no index — an inexcusably amateur 
oversight. Without an index, it is close to 
impossible to learn what Touch-Up can do 
without reading the manual over and over 
again. Second, the manual is poorly writ- 
ten, using the passive voice and many in- 
exact terms or phrases. I'll give it a better 
rating than most MichTron manuals, but^ 
it could do with improvements. | 

Other weaknesses include the lack of 
multiple magnification levels (only 2x 
and 4 x), the slowness of the redraw and 
the glacial response time of some features 
(although a "lightning" mode is available, 
with fewer features), only one work- 
screen, the Undo key doesn't work and an 
awkward or poorly conceived user 
interface — for example, the nonrepetitive 
arrow buttons in the text-size dialog box 
and no grey scales. These faults combine 
to make what should be one of the best 
art programs around, merely a good pro- 
gram. Migraph should, and could, do bet- 
ter. I hope they heed this and upgrade 
both the minor program flaws and the. 
manual. ' 

Lazy Paint is a different type of pro- 
gram. It's a lot simpler, with fewer bells 
and whistles, but it has quite a few spe- 
cial items, such as three different grey- 
scales pattern bars, pattern search, por- 
trait to landscape toggle, .PI3, .IFF, Post- 
script and .IMG file support, disk 
information tools, direct scanner support, 
user-definable filters for the clip box or 
the entire image and pointer coordinates 
displayed. 

While the basic drawing tools in Lazy 
Paint are pretty much standard, the pro- 
gram is clean, smooth and easy to use. 
The few bits of chrome they chose to add 
are well thought-out and useful — not 
merely for show. It hasn't the muscle of 
Touch-Up, but it's still a nice program and 
one to consider for mono-only system.s. 

Rough (or ZZ-Rough) is France's answer 
to Neochrome. It's a low-resolution paint 
program that approaches the idea from 
a different angle. The program uses the 

(to page 98) 
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'_)eing able to measure time accurately in a software program can be helpful and sometimes essential. For real time 
applications dealing with multiple events occurring outside the computer, it can be critical to know the exact time 
when those events occur. One example is in MIDI applications dealing with the time of occurrence of note-on or 
note-off commands. Unfortunately, it isn't always obvious just how to go about measuring time, especially if one 
isn't familiar with the details of the ST's hardware. 

Real-time programs aren't the only ones that can make use of time-measurement techniques, though. Consider 
how nice it would be to have an easy way to program precise time delays or to measure the time required to execute 
a critical path in the new program you've just completed. Another useful software development tool might allow 
you to scatter markers through a troublesome program, giving a readout of the elapsed execution time between 
markers. In this article, we will develop these tools and provide the basis for others. 

With one exception, the program functions are written in C, but they are well commented, which will allow you 
to transfer the ideas to the language of your choice. The millisecond timer's interrupt-service routine is the excep- 
tion. It is written in 68000 assembly code because it is required in order to run in supervisor mode and must return 
using the privileged RTE instruction. All code was written using the Alcyon C Compiler included with the Atari 
Developer's Package, but should be adaptable to other C compilers with few if any changes. 
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LLISEGOND TIMER 



BY ROBERT H. OSNESS 



What time is it? 

The ST contains a real-time clock, but 
the clock's time values are accumulated 
in increments of two seconds — not a very 
useful resolution for events happening at 
electronic speeds! Unbeknownst to rnany 
of us, however, the designers of the ST 
cleverly included a 68901 multi function 
peripheral (MFP) chip, which has four 
(count 'em) programmable timers. Most 
of these are allocated to various system 
functions, but one. Timer A, has been left 
for applications — that's us, folks! 

When enabled, Timer A will generate 
an interrupt after a programmable num- 
ber of cycles of its 2.4576 MHz input clock 
have elapsed, then reload itself for 
another timing cycle. Our program uses 
the ST's XBIOS functions Xbtimerjenbint 
and Jdisint to set up the timer and to en- 
able or disable the associated interrupt. 
We program the timer to generate an in- 
terrupt every 1.0 millisecond, and use the 
interrupt to increment a memory word 
used as a counter. Reading the counter al- 
lows us to measure time directly in mil- 
liseconds. 

It's possible to set up the timer to in- 
terrupt more frequently than once every 
millisecond, but it's not very desirable, be- 
cause that could slow the ST in perform- 
ing its other tasks. If greater timing 
resolution is necessary, there are better 
ways to get it as a future article will show. 

The timer iSR 

Where there are interrupts, there must 
be ISR's — that is, interrupt service rou- 
tines. These are just like subroutines or 
function calls, except that a branch to the 
code they contain is executed when the 
corresponding interrupt occurs. The ISR 
then restores control to the normal pro- 
gram, wherever it was when the interrupt 
struck. 



Listing 1 contains the assembly code 

for intr, the millisecond timer's ISR. It 

is intentionally very short, to minimize 
system delays. All that happens is that the 

global variable timcnt is incremented, 

and then the interrupt in-service bit is 
cleared before returning to the main pro- 
gram. The variable timcnt contains the 

number of elapsed milliseconds since it 
was last initialized or cleared. It is 
declared as a long integer to allow time 
values greater than 65 seconds to be ac- 
cumulated, which would be the limit for 
a regular 16-bit integer. Note that no 
register contents need to be saved in this 
ISR, because none are used. 

The underscore must appear in front 

of the variables timcnt and intr for 

compatibility with the C compiler, which 
adds underscores to external variables. 

The variables timcnt and intr are 

declared as globals because the ISR is to 
be linked with the C code as a separately 
compiled module. The underscores are 
not used in the C source code. 

The tools 

Listing 2 contains the tools that expand 
the horizons of the millisecond timer into 
the real world. Let's skip over the main 
program segment for a moment and look 
at the subroutine functions. 

Let's get storied 

The function init tmr( ) is used to set 

up the timer. Jdisint is an XBIOS function 
that disables Timer A's interrupt. Xbtimer 
is then called to set up the timer's pres- 
cale divider ratio, countdown value and 
ISR vector — that is, the ISR's address. 

Jenabint is called to enable the timer's 
interrupt, and the millisecond timer is off 
and running! For those who want to know 
more of the hardware details, there are 
specifications for the timer in the 68901 



data section of the Atari Developer's Pack- 
age, beginning on page 984. 

Delays, anyone? 

Next, let's look at the function 

wait ms(ms). By passing a long-integer 

millisecond value to the function, we 
cause it to enter a timing loop, where it 
remains until the specified number of 
milliseconds have elapsed. Simple, isn't it? 

There is a similar function for longer 

delays, wait sec(sec). It is the same, except 

that a long integer value for seconds of 
delay is passed. 

Marking time 

Now for a little more fun. To measure 
the execution time between two points in 
a program, we can use the function 
cak ms( ). At the first of the two measure- 
ment points, we simply insert the state- 
ment tl = timcnt, where tl is a long 
integer. Then, at the second measurement 
point, we insert a call to cak ms( ), pass- 
ing the tl and the string "since tl." The 
subroutine will measure the elapsed time, 
and will print the result to the screen as 
"Elapsed time = xxx milliseconds since 
tl," where the last two words are the string 
passed by the calling routine. 

Successive calls can use additional 
declared variables t2, tS, etc. The time 
difference is also returned as an 16-bit in- 
teger, which may be used or ignored. Note 
that the variable t2 used inside this 
subroutine is local and is not the same as 
the variable t2 used in the main program. 

The main thing 

Now let's look at how main( ) tests the 
timing subroutines. First we initialize the 

timer with a call to init timer( ). Next 

comes a whik loop, where we will remain 
until typing a "q" to quit. The first print/ 
statement prints the counter value, which 
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should be 0 because the timer has just 
been started. Next is a 100-millisecond de- 
lay, then another /)n'n</' statement to show 
how much time has elapsed to this point. 

Now comes a combined test of the mil- 
lisecond and second delay subroutines. 
The time is sampled in tl, then delays of 
ten seconds and 250 milliseconds are 

called, and finally calc ms( ) is called to 

measure the elapsed time since tl. 

Next is a test of a the execution time 
for a dummy for loop, which executes 
9,000 times. The value of t2 is used to in- 
dicate this result. 

Last, another call to calc ms( ) is used, 

with a zero in place of the identification 
string. This is just a variation in how the 
subroutine can be used if no id is needed. 

The end of the loop has now been 
reached, and the user can enter a "q" to 
quit or repeat the sequence as many times 
as desired. 

Let's build the program 

Disk subscribers may now gloat, get out 
their program disks and skip the re- 
mainder of this section. Everyone else, 
please follow along! 

Begin by typing in the timer ISR in 
Listing 1. Using the assembler disk in 
Drive A and your working disk in Drive 
B, assemble it using the batch file of List- 
ing 3, BI2.BAT 



Now type in the C program TIMERS.C 
from Listing 2, and compile and link it 
using the batch file from Listing 4, 
BINT.BAT. Note the inclusion of "b:intr" 
in the link statement, to link in the ob- 
ject file INTO generated in the preced- 
ing step. Both of the batch files can be 
adapted to RAMdisk with minor modifi- 
cations in order to speed assembly if 
desired. 

Time to fly! 

All that remains is to watch time fly. 
Click on TIMERS.PRG and we're off In 
about 10.5 seconds, the first pass through 
the main loop will be complete, and we 
can look at the results. 

At first glance, our 100-millisecond de- 
lay seems too long. Actually, the addition- 
al delay indicated on the second line of 
output is caused by the execution time of 
the print/ function. This is demonstrated 
when we look at the next line. Exactly 
10,250 milliseconds (that's 10.250 seconds) 
are indicated for the execution time of 
the ten-second and 250-millisecond 
delays. 

The fourth line of output indicates that 
our dummy for loop takes 75 or 76 mil- 
liseconds to execute: about 8.3 microse- 
conds for each pass through its loop. 

The fifth line shows that the use of 
calc ms( ) with a zero string parameter 



works as desired. It also indicates a delay 
of about 24 to 56 milliseconds due to the 
/)rm</'statement contained in the preced- 
ing call to calc ms( ). 

Repeating the main program loop 
shows that the use of printf inserts a vari- 
able delay of 18 to 56 milliseconds. 
Though this is really not a long time in 
the human world, it can be of some im- 
portance in code segments that have to 
be fast. 

Conclusion 

In a future article, we will take a look 
at some ways to get even more timing ac- 
curacy. Until then, you may want to ex- 
pand the program and try some code 
timing of your own. ■ 




Bob Osness, who has been programming his 
5T for 2 'A years, works as an electrical engineer 
for Boeing Aerospace in Kent, Washington. He 
and his wife, Georgia, spoil grandchildren as 
a hobby. 
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Listing 1: 
Assembly 



. 3 1 0 

. glo 

.tex 

_int 

addq 

andi 

rte 

.dat 

. eve 

-tin 



-tincnt 
-intr 



bl 
bl 
t 
r ! 

1 «Sl,_tincnt 
b tt$DF, SfffaBf 



cnt: .dc.L 8 
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Listing 2: C 



ttindude <stdio.h> 
ttindude <osbind.h> 

extern long tincnt; 
extern int intrO; 



nain C) 
C 



long tl, t2; 
int i ; 
char k; 

k = O; 

init_tnr C] ; 

uhileC k != 'q') { 



/» tine counter »/ 
/* ISR reference */ 



/* tine values */ 
/* loop count */ 

/* loop exit control character */ 



/* initialize & start nsec tiner */ 



printf ("Initial tincnt value is XDSn", tincnt]; 
wait-nsdOBL) ; /• 18B nsec delay */ 

printf ("After first delay, tincnt = XDSn", tincnt) i 



tl = tincnt; 
wait_sec (lOL) ; 
uait_ns(2SeL) ; 

calc-nsCtl, "since tl") ; 

t2 = tincnt; 
fortirfl; i<988e; i++) 
k = k; 



/* tine narker «1 «/ 
/* 18 second delay */ 
/* 258 nsec delay */ 

/* result should be 18258 nsec */ 

/* tine narker «2 */ 
/* dunny code loop */ 
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calc_ns (t2, "since t2") ; /* dunny code execution tine */ 




calc_ns(t2, BL) ; /* sane call without id string */ 




printfC'To quit, type a 'q', otherwise ") ; 
printf ("strike another key \n"] ; 
k = Bconin(2); 

> 




Jdisint(13)< disable tiner a interrupt: 

required before exit!! */ 




> 

init_tnr(J /* Initialize Tiner A */ 




{ 

tincnt = 8; 




JdisintC13); /* disable tiner a interrupt */ 




Xbtiner (8x88, 8x84, 49, intr); /* set up tiner a: 

0x84 - prescale divide by 58 

49 = count down value 
intr = interrupt vector 

(ISR address) */ 




Jenabint(13) > /* enable tiner a interrupt */ 

> 




wait_ns(ns) /* Delay 'ns' nilliseconds */ 

long ns, 

t 




long delta, tl; 




delta = 8; 
tl = tincnt; 










while(delta < ns) ( 

delta - tincnt - tl; 

} 

> 
















wait_sec (sec) /* Delay 'sec' seconds */ 

long sec; 

t 






long diff, tl; 










dift = 6; 
— 'tincn't' 






while(diff < sec) C 

uii 1 — wiintiiv \x» f xDUDf conv?rx TO ScCOnuS ^/ 

> 






J 

calc_ns(tl, str) /* Calculate elapsed tine in nilliseconds */ 










long tl; 
char «str; 
{ 






long t2; 










t2 = tincnt; 






if (str) 

printf ("Elapsed tine = XD nsec Xs\n", t2 - tl, str); 

else 

printf ("Elapsed tine = XD nsec \n", t2 - tl) ; 










return((int) (t2 - tl)); 
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} 


CO 


Listing 3: 
Daicn Tiio 






as68 -F b; -1 -u Xl.s 
wait 














MILLISECOND TIMER 
Listing 4: 
Batch file 










cpC8 XI. c XI. i 

cOG8 XI. i Xl.l XI. 2 Xl.3 -f 

rn XI. i 

cl68 Xl.l XI. 2 Xl.s 
rn Xl.l 
rn XI. 2 

as68 -F b: -1 -u Xl.s 










link68 Cu] xl . 68k=genstart, Xl, b : intr, genl ib, osbind, 1 ibf 
relnod Xl 
rn X1.68K 






wait 


END 
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LOW RESOLUTION ONLY 



The 

Game 

Cupboard 

BY MARK E. NELSON 
It seems that every suburban family room has one. Its stacks 

of taped-up cardboard boxes rattle noisily each time an evening 

of gaming begins. And four partial decks of cards rot for years 

in there, because those missing cards just may turn up. It's the 

game cupboard. Here's a game cupboard for your computer. And, 

as in any good game cupboard, there's something for everyone. 

ST-LOG JULY 1989 




Note: The program 
listing at the end of this 
article is included only 
for those people who are 
interested in program- 
ming in Pascal. The pro- 
gram will ru>t run with- 
out several picture files, 
which are included, 
along with the complete 
program, on this 
month's disk version or 
in the databases of the 
STLOCi ST users' 
gtoup on DELPIU. It 
is, of course, impossible 
to include the picture 
files within the pages of 
this magazine 



As in any 
good gome 
cupboard, 
there's 
something for 
everyone. 



Getting started 

Double click on CUPBOARD.PRG to 
begin (you must be in low resolution). 
You'll see the cupboard with a game sit- 
ting on each shelf. To play a game, just 
point to it and click the left mouse but- 
ton. To leave the game cupboard, click in 
the EXIT box in the lower right-hand 
corner. 

Naughts and Crossas 

For the kids, there's a two-level tic-tac- 
toe game called Naughts and Crosses. Even 
adults may find it challenging to figure 
out how to beat the computer at this sim- 
ple game. Click on EASIER or HARDER 
to set the level of play, and on EXIT when 
you're done playing. The computer will 
always let you move first. 
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MYSTIC ANSWERER 



Repeat 

For older kids and adults, there's a 
memory game called Repeal. The com- 
puter will show a sequence of colored 
lights, and you must repeat it. The se- 
quence will begin with one light, and 
continue to grow until you can't repeat 
it. Just click on a light to light it up. The 
highest score is saved to disk and dis- 
played at the top of the screen to give you 
something to shoot for. Click on EXIT 
when you're done and ready to return to 
the cupboard. 

Mystic Answerer 

For everyone, there's an eight ball, 
called the Mystic Answerer, that knows the 
answers to all of life's questions. Just ask 
a question out loud, and then click the 
left mouse button to make the ball roll 
over and reveal the answer to your ques- 
tion. Of course be sure to ask your ques- 
tions so that they require yes or no 
answers. Click on EXIT when you've had 
all of your questions answered. 

Notes for programmers 

I wrote The Game Cupboard using OSS 
Personal Pascal Version 2. The comment- 
ed source code is shown at the end of this 
article and is also included on this 
month's disk. Feel free to use any por- 
tions of the code as long as you include 
the message: "Portions of this program 
were published in ST-LOG and were writ- 
ten by Mark E. Nelson" on the title screen 
and in the source code of your program. 
The sound routines are modified ver- 
sions of those found on the OSS bulle- 
tin board. The modified routines are not 
totally disabled by key clicks as are the 
original routines. 

The code should be fairly straightfor- 
ward. I don't use many shortcuts or tricks. 
But if you do have any questions, leave 
me a message or mail on the Atari Con- 
nection BBS at 801-377-1617. ■ 




Mark Nelson is a computer science student 
at Brigham Young University and the father 
of three boys, Drew, Steven and Aaron. He 
spends his free time coaching tee-ball, wrestling 
on the family room floor and watching Sesame 
Street. 
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THE GAME CUPBOARD 

Listing 1: 

Pascal 



The Gane Cupboard 
Mark E. Nelson 
February 12, 1988 



C Title The Gane Cupboard version 1. 

Author 
Last Update 

} 

Progran The_Gane_Cupboard; 

i 

Copyright Cc3 1988 by ST-Log 
Portions of this code nan be used freely as long as the title 
screen contains the nessage, "Portions of this progran were 
published in ST-Log and were viritten by Mark E. Nelson." 




C$1 Gensubs.pas> 
C$1 Auxsubs.pas} 

Const 

{ constants for sound routines ) 

end-write = 128; 

cnd_read = 6; 

chana-lo = 0; 

chana.hi = IJ 

chana_vol = 8; 

chan.enable = 71 

enable_sound=7; 

C nusical notes for use with sound routines } 

A2 = eoe; 



82 
C2 
D2 
E2 
F2 
a2 
A3 
83 
C3 
D3 
E3 
F3 
G3 
A4 
Al 
81 
CI 
Dl 
El 
Fl 
Gl 



538; 
476; 

437; 

: 39G; 
: 358; 
: 318; 
: 388: 
: 265; 
: 235; 
: 220; 

: 198; 
: 175; 
: 157; 
:150; 

: 1280; 
: 1B60; 

: 940; 
: 880; 
: 808; 

: 788; 
: G20; 



My_8roun = 
Sane = -1; 



Type 
Channel = 0. .2; 



{ for sound routines > 






lights.array = array [1 .. 2501 of integer; 
Screen_ptr = Record 

case boolean of 
False: (p :*Screen_L) ; { Screen_L defined in AUXSUBS.PAS J 
True: CI : Long-integer) ; 
end; 

Uar 

Noise, Tone: boolean; C for sound routines } 

Exit-Gane, Button: boolean; 
house_x, Mouse-y, nun_answers: integer; 
Msg_Area : Message-Buffer ; 

Eight_Scr, Cupboard_Scr, Nought_Scr, Repeat.Scr: 
Roll-Eight! arras[1..5] of Screen_ptr; 
board: array[1..9] of integer; 
answers: array [1 .. 100] of string; 

Function Randon CMax: Integer) : Integer; 

foruard; 

Function GetRez : Integer; 
X8I0SC4] ; 

Function physbase: long_integer; 
)t810S(2] ; 



Screen_type; 



Function logbase 

X8I0SC3) ; 
Procedure setscreen tlogadr 

XBIOSCS); 



long_integer; 

physadr : 



long.integer; res: integer); 



Procedure Sav_Scn CSav.To : Screen_Ptr); 
war Saw_Fron: $creen_Ptr; 
begin 

Sav-Fron. 1 :=Physbase; 
Sau_To . ! =Saw_Fron . 
end; C of Proc Sav_Scn } 

Procedure Rest_Scn CSa«_Fron : Screen_Ptr)J 
var Sa«_To! Screen_Ptr; 
begin 

Sav_To . 1 : =Physbase; 

Sav_To . p^ : =Sav_Fron . p* 
end; { of Proc Rest_Scn > 

Procedure Str (value : integer; var nunberistring) ; 

C This Procedure converts an integer value to a string of digits } 
Uar 

tenp, I : Integer; 
Gotit : boolean; 
begin 
Gotit:=f alse; 
Nunber:=' ' ; 
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If value<e then begin 
Nunber :='-'; 
Ualue : =abs Cvalue) ; 
end; 

If value=e then nunber!='e'; 
For I:=4 dounto B do begin 

tenp:=value div round (purof ten (I) ) ; 

If tenp>6 then Gotit:=true; 

If Cotit then nunber : =concat Cnunber, chr Cord (48] -ttenp] ] i 

Ualue ! =Ualue- tenp»round (pwrof ten CI) ] 

end 

end; C of Procedure Str } 





Procedure Main.Event (Tine : Long. Integer) ; 

formard; 

Procedure Box-CndCcnd, il, i2, i3, i4, iS, iE, i7, iS: integer; Uar outl, out2 : integer) ; 
Uar 

Int_in: Int_in-parns; 
Int-out : Int_out_parns; 
Addr_in:Addr_in_parns; 
Addr.out : Addr_out_parns; 

Begin 
int_ 
int 
int 
int- 
int 
int_ 
int_ 
int. 
AES. 
outl 
out2 
End; 



= il; 
= i2; 
= i3; 
=i4; 

:i5; 

=16; 
=i7; 
= i8; 

Call (end, int_in, Int.out, addr.in, addr.out) ; 

:=int_out[l] ; 

!=int_out[2] 

{ of procedure Box.Cnd } 



inCei 
inCl] 
in[2] 
in[3] 
in[4] 
inESI 
inlGI 
in[7] 



Procedure Grou_Shrink (end, snall_x, snall.g, snall.u, snall.h, 
big_x, big_y, big-w, big_h : integer ); 

Uar 

int_in : Int_in_parns; 
int-out : Int_out_parns; 
addr_in ! addr-in_parns; 
addr_out : addr_out_parns; 

Begin 
Int_in[e] 
Int-intl] 
Int_in[2] 
Int_in[3] 
Int_in [4] 
Int_int5] 
Int_in[6] 
Int.inC?) 



=snal I_x; 
=snal l_g; 
=snal l_u; 
: =snal l_h; 
:=big_x; 
::big-y; 
!=big_w; 
=big_h; 

AES.Cal 1 (end, int_in, Int_out, addr_in, addr.out) 
End; { of Procedure Grow.Shrink ) 
Procedure Grou.Box (snal I_x, snall_y, snall.w, snall-h, 
big_x, big_y, big_u, big_h: integer) ; 

Begin 

Grou-Shrink C73, snall.x, snall_y, snall_w, snall.h, 
big_x, big_y, big_u, big_h} 
End; { of Prodedure Grou_Box } 

Procedure Shr i nk_Box Cb i g.x, big.y, big_w, big_h, 

snall_x, snall.y, snall_u, snal I_h : integer) ; 

Begin 

Grou-Shrink (74, snall_x, snall_y, snall-U, snall_h, 
big_x, big_y, big_u, big_h) 

End; { of procedure Shrink_Box ) 

Procedure Move_Box (x, y, w, h, new_x, New_y : Integer] ; 
begin 

Grou_Shr ink (72, w, h, x, y, new-x, new_y, 0,0) 
end; C of procedure ftove.Box > 

Procedure Mait( Seconds: Long-Integer); 
Uar Message:Message_6uf f er; 
d: Integer; 

Begin 

Seconds:=SeeDnds»100B; 
Main-Event (Seconds) 
End; { of procedure Wait ) 

Function gia-read (data, register: integer) : integer; 
XBIOS (28); 



register : integer) ; 



Procedure gia.urite (data, 
XBIOS (28); 

Procedure Sound-init; 
Uar 

Port-State: integer; 
Begin 

port-state:=gia_read(8, ehan_enable+cnd-read) ; 

gia-wr i te (port-state&C'^enable-sound), ehan-enable-icnd-wri te) ; 

(Next three lines added by ne) 

port-State : =gia-read (8, 7tend-read) ; 

gia-write (port-State | 56, 7-(-cnd-urite] ; 

port-state:=gia-read(0, 7+end-read) ; 

If Noise then gia-write (port-State £ (^56) , 7+cnd-urite) 

else gia-write (port-State I 56, 7+end-urite] ; 
port-State : =gia-read (6, 7'>end_read] ; 

If Tone then gia_write(port-state S (^7), 7+cnd_urite) 
else gia-write(port_state | 7, 74^cnd-urite) 

End; C Of Procedure Sound-init } 



Procedure Sound (eh : channel ; 
Begin 



pitch: integer; vol : integer) ; 
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Sound_Init; 

9ia-writetvol> chana-vol-f-cht-cnd-write] ; 
9ia_write CpitchS$FF, chana_lo+ch*2+cnd-write) ; 
Sia-wri te Cshr (pitch, 8) , chana-hi'i'Ch«24'cnd_wri tel ; 
gia_uriteCpitch&$FF, S-^cnd-urite] 
end; C Of Procedure Sound } 

Procedure Sound.off; 

Uar 

port-State: integer; 
Begin 

Sound ce, e, B) ; 
Sound CI, e, 0) ; 
Sound (2, 0, 61 ; 

port-state:=gia-readCB, chan-enable-^cnd-readl ; 
gia_urite (port-State I enable-sound, chan-enable^-cnd-uritel 
end; C Of Procedure Sound-Off } 

Procedure Uait_Sound(Tine: integer] ; 
war X, u, j ! Integer; 
Begin 

For J;=l to 100 do For x:=l to Tine do y: 
end; C Of Procedure Uait-Sound } 



:x«100-3+14« diu 100 



Procedure Urong_Sound; 
Uar 

Count ! Integer; 
Begin 

Tone ! =True; Noise ::False; 
For Count:=l to 2 do begin 

SoundCl, 22£e, ISl; 

Sound (2, 2538, 15) ; 

Sound(e, 2260, 15); 

Uait_Sound(3e) ; 

Sound-Off ; 

Uait-SoundC41 

end 

end; I Of procedure Urong-Sound } 

Procedure Happy-Sound; 
Uar 

Uolune, Note: Integer; 
Begin 
Uolune:=12; 

Tone:=True;Noise!=False; 
For notes=l to 3 do begin 

Sound (0, a2, uolunel ; 

Sound (1, c2, volunel ; 

Sound(2, e2, volune) ; 

If Note=l then Uait-Sound (68] else Uait-Sound C3S] ; 

Sound-of f; Uait-Sound (1] 

end; 

Sound (0, a4, volune] ; 
Sound (1, c3, volune] ; 
Sound (2, e3, volune] ; 
Uait-SoundC2ee] ; 

For Note:=l to volune-5 do begin 

Sound CO, a4, volune-Note] ; 

Soundd, c3, volune-Notel ; 

Sound (2, e3, volune-Note] ; 

Uait-Sound (2] 

end; 
Sound_of f 
end; C Of Procedure Happy-Sound } 

Procedure Conp-noved-Sound; 
var volune: integer; 
begin 

tone:=true; noise:=f alse; 
volune:=12; 
Sound (0, a4, volune] ; 
Sound (1, a3, volune] ; 
Sound (2, a2, volune] ; 
uait_sound (28) ; 
Sound (8, a3, volune] ; 
Sound (1, a2, volune) ; 
Sound (2, al, volune] I 
wait-sound (28) ; 
Sound-Off; 
end; C of Procedure Conp-noved_Sound } 

Procedure Hun-noved-sound; 
var volune: integer; 
begin 

tone:=TRUE; noise : =FALSE; 
volune:=12; 
Sound (8, a3, volune) ; 
sound (1, a2, volune) ; 
sound (2, al, volune) ; 
wait-sound (28) ; 
sound(0, a4, volune) ; 
sound (1, a3, volune) > 
sound (2, a2, volune) ; 
wait-sound (28) ; 
sound-of f ; 
end; C of procedure Hun-noved_sound } 



Procedure Lights-Sound (Light, 

var volune: integer; 

begin 

tone:= TRUE; noise:= FALSE; 
volune : =12; 
Case light of 
1: begin 

Sound (8, a3, volune] ; 
Sound (1, a2, volune) ; 
Sound(2, al, volune) ; 
end; 
2: begin 



Length: integer); 



Sound (0, b3, volune) ; 

Sound (1, b2, volune) ; 

Sound (2, bl, volune) ; 
end; 
3: begin 

Sound(d, c3, volune) ; 

Soundd, c2, volune) ; 

Sound (2, cl, volune) ; 
end; 
4: begin 

Sound (0, d3, volune] ; 

Sound (1, d2, volune] ; 

Sound (2, dl, volune) ; 
end; 

end; 

Uait-Sound (Length) ; 
Sound_of f ; 
end; { of procedure lights-sound > 

Procedure Correct-Sound; 
Uar 

Uolune, Note: integer; 
Begin 
UoIune:=ll; 

Tone : =True; Noise : =False; 

Note::l; 

Repeat 

Soundd, 993-Note, Uolune) ; 

Sound C2, leOl-Note, Uolune) ; 

Sound [0, 997-Note, Uolune) ; 

Note:=Note+15; 
Until Note>100e; 
Sound_of f 

end; { Of Procedure Correct-Sound J 

Function XB_Rnd:Long_Integer; 
XBI0S(17) ; 

Function Randon; (Declared prior with FORUARD } 
var I: Integer; 
Begin 

I :=Abs(Int(XB_Rnd) Mod (Maxi-l)); 
If (Kl) OR (I>Max] then I : =Randon (Max) ; 
Randon : =1 
End; C of Function Randon > 

Procedure Get-Out; 

( exits the progran unconditionally } 
Begin 
Exit-Gen; 
Halt 

End; C of procedure Get_out } 

Procedure Main-Event; C declared prior with FORUARD } 
Uar d, event, bstate : integer; { d is a dunny variable > 

begin 

event :=Get_Event (E-Button I E-Tiner, 1, 1, 1, Tine, 
False, e, 8, 0, 6, False, 8, 8, 8, 8, 
nsg_area, d, d, bstate, House_x, Mouse_y, d] ; 

If (Event S E-Button) <> 6 ( Then a button has been pressed } 
then 

button:= TRUE 



else 
button 



end; 



false; 

( of procedure Main-Event } 



( a tiner event has occured } 



Procedure Get_Button; 
begin 

Repeat 

Main-Event(108] 

Until button; 
end; C of Procedure Get_Button ] 



C wait for nouse button input > 



Procedure Init-Screens; 

( set up the eight ball screens } 

var i: integer; 

log: long-integer; 
begin 

hide-nouse; 

set-clip(B, 0,328, 288); 
log : =logbase; 
for i:= 1 to 5 do begin 
new(Roll_Eight[i] .p) ; 
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, C4+i)); 
C7+i))i 



Roll-EightCi] .p* 
end; 

setscreen CRol l_Eight [1] . 1, 
paint-color Cblack] ; 
paint-Style CI) ; 
paint-oval (158, 116, 67, 67) : 
paint-Color (white) ; 
paint-oval (158, 125, 28, 28) ; 
paint-Color (black) i 
for i:=l to 5 do begin 

frane-oval(158, lie, (4ti) 

f rane-oval (158, 131, i8*ii 
end; 

setscreen(RaIl-Ei9ht[2] . 1, 
paint-color (black) J 
paint-oval C1S8, 130, 95, 95) ; 
paint_color (white) ; 

paint-oval(158, 177, 35, 35): C 
paint-color (black) ; 
for i:=l to 8 do begin 

f rane-oval (158, 1G8, C4+i], (4+i]) ; 

f rane-oval (158, 189, I5*ii. (7+i]] ; 
end; 

setscreen(Rol l_Eight [3] . 1, Sane, Sane) 
paint-oval (158, 140, 110, 110) ; 



Eight-Scr.pic; { Each gets a copy of 8 ball screen ) 
Sane, Sane); { work on screen 1 ) 

I 8 ball itself ) 
( white circle in 8 ball ) 



{ draw top circle of 8 > 
{ botton circle of 8 } 



Sane, Sane); ( work on screen 2 } 
{ 8 ball itself ) 
C white circle in 8 ball 



I work on Screen 3 } 
{ 8 ball itself } 



setscreen (Rol l_Eight [4] . 1, Sane, Sane); { work on screen 4 ) 
paint-oval (158, 150, 125, 125) ; { 8 ball itself } 

paint-color(ll) ; ( dark blue > 
paint-round-rectdlO, 60, 100, 15) ; 



{ work on screen 5 } 
{ 8 ball itself ) 



I ] [ 



OK 



]•,!)! 



( Read picture screens > 



setscreenCRoll-Eight[5] . 1, Sane, Sane); 
paint-color (black) i 
paint-oval (158, 160, 140, 140) ; 
paint-color(ll) ; C dark blue } 
paint-round-rect (188, 110, 120, 38) ; 

setscreendog. Sane, Sane); 
show_nouse; 
end; C of procedure init_screens ) 

Procedure Initialize; 
Uar 

Rez, x: integer; 
f: file of text; 
begin 
Hide-House; 
Exit_liane:= FALSE; 
Rez:=GetRez; 
If Rez=l then begin 

x:=Do-Alert ('[SIC I Switch to Low Resolution 

Get-Out 

end; 
Clear-Screen; 

xi^Read-ScrnC CUPBOARD, PIl', Cupboard-Scr) 
ScrRest(Cupboard-Scr) ; 
Set-Mouse (H-Bee) ; 
Show-Mouse; 

x:=Read-ScrnCEIGHT.PIl', Eight-Scr) ; 
x :=Read-ScrnC NOUGHT. PIl Nought-Scr) ; 
x::Read_ScrnC REPEAT. PIl', Repeat_Scr) ; 
Reset(f, 'ANSMERS.EIT') ; 
nun-answers : =0; 

Uhile ((NOT E0F(f]) AND (nun-answers<lBe)) do begin 
nun-answers : =nun-answers+l; 

ReadlnCf , answersCnun-answers]) ; ( read 8 ball answers } 
end; 

closeCf); 
Init-Screens; 
Set-Mouse (M-Arrow) ; 
end; ( of Procedure Initialize } 

( KKXKXKXKKKKKKKKKXXXKKKXKXXXXKXXIIMXMXKXKKKKMKXKKKKKKKKXXXXKXKKKKXMXKXKKXM 

KxxxKxxMxxxxxxxxxxxxKxxxKX Repeat Procedures xmxxkkkxxxxkxxxxxxxxxmxkxxxx 

KXKKXXXXXKXXKXXXXXKKKXXKXXKXKXXXXXKXXXXKXXXXXXKXXXXKKKXXXXXKXXXKKXXXXXXXX ) 

Procedure I ight (which-I ight, length: integer); 
Const 

w = 78; 

h = 43; 

begin 

hide-nouse; 
case which-light of 
1: begin 

Paint-CDlor(6) ; 
Paint-Rect(77, 32, w, h) ; 
lights-sound(which-light, length) ; 
Paint_Color(2) ; 
Paint-Rect (77, 32, w, h) ; 
end; 
2: begin 

Paint-Color (8) ; 
Paint-Rect (172, 32, w, h) ; 
lights-sound(which-light, length) ; 
Paint-Color (14) ; 
Paint-Rect(172, 32,w,h); 
end; 
3: begin 

Paint-Color(0] ; 
Paint-Rect (77, 100, u, h) ; 
1 ights-sound (which-1 ight, length) ; 
Paint-Color(4) ; 
Paint-Rect(77, 100, w, h) ; 
end; 
4: begin 

paint-color(lO) ; 
Pa int-Rec t (172, 100, w, h) ; 
1 ight s-sound (which-1 ight, length); 
paint-Color (11); 
Paint-Rect(172, 108, w, h) ; 
end; 
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end; 

show-nouse; 
end: { of procedure light } 

Procedure Show-LightsCvar lights: lights.array 
C Shows the previous noves and adds another > 
var i, length: integer; 
begin 

wait_sound(20e] ; 

count!=count+l; 

if Ccount< 6) then length:^ 166 

else if Ccount<ill then length:=75 

else if Ccount<i6) then length:=S6 

else if (count<21] then len9th;=48 

else if Ccount<26] then length:=35 

else length:=36; 
1 ights [count] : = randonC4]; 
for i:= 1 to (count-i) do begin 

lightClightsCi], length): 

wait-sound ( (length div 16)); 

end; 

1 ight (1 ights [count] , IBB); ( show last light a tad longer } 
end; [ of Procedure Shou-Uights > 



var count: integer); 



C pause a nonent ) 
{ inc count } 
I set sound length > 



{ add a new light } 
{ show the lights ) 



Procedure Get-A-Light (1 ights : lights.arrag; which-light: 

var Urong, Exit-Repeat: boolean); 
var Xj g, selected, i: integer; 

OK: boolean; 
begin 

selected:=e; 



integer; 



0K:= FALSE: 
Repeat 
get.button: 
x:= nouse_x 
if (tx>=72) 



Left side } 
top Left } 



£ botton left } 



Right Side } 
top right ) 



{ botton right } 



y:= nouse_y: 
AND (x<=14e)) then 
If (ta>=32) AND (g<z74)) then 

selected:=l else 
if (Cy>=iaO] AND (y<=142]) then 
selected:=3 else 

if^t£x>=172) AND Cx<:241)) then 
If (tg>=32) AND (a<=74)) then 

selected:=2 else 
if ((y>=100) AND (y<=142]] then 

selected:=4; 

If (tx>=141) AND tx<=178) AND Cy>=82) AND ta<=92)) 

then Exit_Repeat:=TRUE: 
0K:= (selectedOB) 
Until (OK OR Exit-Repeat): 
1 ight (selected, 50): 

If (selected=which-l ight) then Mrong:=FALSE 

else Urong:=TRUE; 
If (Urong AND (NOT Exit-Repeat)) then begin 

wrong-sound: 

for i:= 1 to 5 do 

1 ight (which-light, 15) : 

end; 

end: C of Procedure Get-A-Light } 

Procedure Get-Lights (1 ights : 1 ights-array: count: integer; 

var gane-over, Exit-Repeat: boolean); 
C gets hunan input and checks for validity. } 
var i : integer; 
begin 

i:::l; Gane-Over:= FALSE: 
Repeat 

Get-A-Light (1 ights, 1 ights [i] , Gane-Over, Exit-Repeat) ; 
i:zi+l; 

Until (Gane-Ouer OR (i>count] or Exit-Repeat): 
end: C of procedure get-lights > 



Procedure Update-Score (var hi, score: integer: 
{ updates the hi score and the reg score } 
var St: string; 
begin 

Kide-nouse; 
Str (score, st) ; 
draw-String(24, 36, st) : 
If (score>hi) then begin 
New-hi:=TRUE: 
hi : =score; 
str (hi, st) : 

draw-string (272, 38, stl ; 
end: 
Show-nouse: 
end: C of procedure update_score } 

Procedure Repeat-Gane: 
var 

lights: 1 ights_array: 
Count, i, hi: integer: 

Exit-Repeat, Gane.Over, Neu_hi : boolean: 

st: string; 

f : file of integer; 

begin 

Grow-Box(118, 88, 76, 3B, 6, 8, 328, 288): 

Hide-Mouse: 

ScrRest(Repeat_Scr) ; 

Show-Mouse: 

Exit-Repeat:= FALSE; New-hi : =FALSE: 

lO-Check (FALSE); 

Reset (f, ' Repeat .hi ') : 

If (IO_Result>=e) then begin 

Read(f,hi]! 

close(fli 

end 
else hi:=B: 



var New-hi: boolean): 



Repeat 

Hide-Mouse: 
Draw-String(52, 146, 



Xlick nouse button to play.'); 
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Shou-Mousei 
get-buttoni 
Hide_House; 
ScrRest(Repeat_Scr) I 
strChi, St] i 

Drau-Strin9(272, 38, st) ; 
Drau_Strin9(24, 36, '8 ■); 
Shou-Mouse; 

Counti=8; Gane_Over:= FALSE; 
Repeat 

Show-l ights (1 ights, count) ; 

Get-Lights (lights, count, Gane.Over, Exit-Repeatl ; 
If NOT Gane-Over then Update.Score (hi, count, New.hi] i 
Until (Gane-Over OR Exit-Repeat); 
Until Exit-Repeat; 



{ save hi score to disk } 



If New-hi then begin 

Rewrite(f , 'Repeat. hi ') ; 

Urite(f, hi) ; 

close(f); 
end; 

hide-Mouse; 

ScrRest (Cupboard-Scr) ; 
Shrink-Box (6, 8, 328, 288, 118, 88, 76, 38) ; 
Show-Nouse; 
end; ( of Procedure Repeat_Gane } 

{ XXKXKXKXXXXXXKKKKKMKKXXKKKXKXKKKKXXXKKXKKKXKKKXKKKKXKKXXXXXKKXKKXXXXKKKK 

KKXKKXKKMKKXKKKKKKKXXXK Eight Ball Gane Procedures kmkxkxkxxxkkkxxxxkmxxk 

XKXKXXKKXXXXXXKXXXXKXKXKXXXXXXXKKKKKXXXXXXXXXXXKXXXKXKKXXXXXXXXXXXXXXXKKX } 

Procedure Shou-Ansuer; 
var i: integer; 

tenp_scr; screen_ptr; 
ans, tenpl, teiip2 : string; 
begin 

Hide_nouse; 
new Ctenp_scr . p) ; 
Sav_Scn (tenp_scr) ; 
for to 5 do begin 

Rest_Scn (Roll-Eight til); 
wait-sound (5) ; 
end; 



C roll the ball } 



i!= randon (nun-answers) ; 
ans : ^answers (il ; 



C randonlg select an answer } 




( parse ans into two strings } 



{ search for space } 



if (length(ans]>14) then 
begin 
i!=15; 

while (i>l) AND (ansIilO' ') do i: = i-l; 
if i<=l then { no spaces found ) 

begin 

tenpl : =ans; 
tenp2:=' ' ; 
end 
else 
begin 

tenpl:=copy(ans, 1, i-1) ; C first i elenents to tenpl ) 
tenp2:=copy(ans, i-tl, (length(ans)-i)); { rest to tenp2 } 
end; 

end 
else 
begin 

tenpl : =ans; 

tenp2 : = ' ' ; 
end; 



< space MAS found } 



Text-color(13) ; 
Set_Color (13, 8, 8, 1888) ; 
Draw-node (2) ; 
if tenp2<>'' then begin 
ODraw-String (168- (4«length (tenpl) ) , 
QDraw-String (168- (4KIength(tenp2) ) , 
end else 

Draw-String(16e-(4«length(tenpl]), 127, tenpl) i 
Show-Mouse; 
Drau-node (1) ; 
Text-Color (black) ; 



C draw the answer } 

122, tenpl); 
132, tenp2); 



{ fade words in } 
{ wait for a button event } 
( unroll the ball } 



for i:=8 to 1888 do 

set-color (13, i, i, 1800) ; 

get-button; 

Hide_nouse; 

for i:=5 downto 1 do begin 

Rest-Scn(Roll_EightCi]) ; 

wait-Sound (5) ; 
end; 

Rest-Sen (tenp_scr) ; 
Show-Mouse; 
dispose(tenp_scr.p); 
end; { of procedure Show-answer } 

Procedure Answer; 

var Exit-Answer: boolean; 

X, g: integer; 
begin 

Exit_Answer:= FALSE; 
Repeat 

get-button; 

x:= nouse-x; y:= nouse-y; 

If ((x>=263] AND (x<=299) AND (y>=189) AND Cy<=199)) 
then Exit_Answer!= TRUE 
else Show-Answer; 
Until Exit-Answer; 
end; { of Procedure Answer ) 



Procedure Eight-Ball; 
begin 
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Grow_BoxC118, 124, 76, 30, 8, 0, 326, 280); 

Hide_Mouse; 

ScpRest(Eight_ScrJ ; 

Show-Mouse; 

Answer; 

Hide_Mouse; 

ScrRest CCupboard_Scr) ; 
Shrink_BoxCO, 6, 320, 208, 118, 124, 76, 38) ; 
Shou-nouse; 
end; t of Procedure Eight-Ball ) 

{ KimilKXXXllMKKXIIICIIKKXmilllCmCKKKMXXmilCKIIlCKllKllKKKIDIKKKKICICltKKlllClimCKKKKllKICKKKK 

KxxxxKKXXMXKXXXKXKXMXXxx Noughts Procedures xxxkkkkxkxkiikmkkkkkxxxkiikkk 

XXXKXKMXKXKKXXXXKMKXXXXKKMM«XXKMKXKKXXK«XXXKKXXXKKMMXXXX«KXK«MKK»XKX»KKK } 

Procedure Shou_Mo«e (Letter s string; nowe: integer); 
( Shows the letter in position held by nove } 
begin 

hide.nouse; 
Text_HeightC2e) ; 
case nove of 

l! Drau-String (103, 34, Letter) ; 

2: Draw_String(146, 34, Letter) ; 

3! Draw_String(191, 34, Letter) ; 

4: Draw_String (103, 67, Letter); 

5: Dra«_String(146, 67, Letter) ; 

6: Draw_String (191, 67, Letter); 

7: Draw_String(103, 99, Letter); 

8: Drau_String(146, 99, Letter); 

9: Draw_String(191, 99, Letter) ; 
end; 

Hun_noved-sound ; 
Text-Height (6) ; 
Show_nouse; 
end; { of Procedure Show-Move > 

Procedure Get-Move(var exit-noughts, harder: boolean); 
{ Gets a hunan noue, shows it, and stores it. 

exit-noughts becones true if exit is clicked rather than 
Mill not allow a nove to a space that is not vacant. > 



{ place an 'x' or an 



Const 
Exit-Top 
Exit-Botton 
Exit-Left 
Exit-Right 
Top 

Top-Mid 
Botton_nid 
Botton 
Left 

Lef t-nid 

Right-nid 

Right 

Easy-Left 

Easy-Right 

Hard-Left 

Hard-Right 



189; 

199; 

13S; 

172; 

10; 

44; 

77; 

112; 

81; 

127; 

172; 

225; 

16; 
64; 

251; 
302; 







var 

done, Left-Col, Mid-Col, Right-Col, Top_Row, Mid-Row, Bot-Row: 
X, y, nove: integer; 

begin 

Exit-Houghts:= FALSE; Left-Col::: FALSE; Mid-Col FALSE; 
Right_Col;= FALSE; Top-Row:= FALSE; Mid-Row:= FALSE; 
Bot-Row:= FALSE; dane:= FALSE; 
Repeat 

Main-Event(188) ; 

If Button then begin 

x::: nouse-x; y:= nouse.y; 
If ((x >= Exit-Left) AND (x <: 
(y >= Exit-Top) AND (y <: 
then Exit-Noughts := TRUE; 



boolean; 



Exit-Right) AND 
Exit-Botton)) 



( Check for Exit ) 



Easy-Right) AND 
Exit-Botton)) 



If ((x >= Easy-Left) AND (x <: 
(y >= Exit-Top) AND (y <: 
then begin 
Hide-House; 
Harder:- FALSE; 
Line-Color (Black); 

Line (Easy-Left, Exit-Botton, Easy-Right, Exit-Botton) ; 
Line (Easy-Left, Exit-Top, Easy-Right, Exit-Top) ; 
Line-Color (My-Brown) ; 

Line(Hard-Lef t, Exit-Botton, Hard-Right, Exit-Botton) ; 
Line (Hard-Left, Exit-Top, Hard-Right, Exit-Top) ; 
show-nouse; 
end; 

If ((X >- Hard-Left) AND (x <= Hard-Right) AND 
(y >= Exit-Top) AND (y Exit-Botton)) 
then begin 
hide-nouse; 
Harder:r TRUE; 
Line-Color (My-Brown) ; 

Line(Easy-Lef t, Exit-Botton, Easy-Right, Exit-Botton) ; 
Line (Easy-Left, Exit-Top, Easy- Right, Ex it- Top); 
Line-Color (Black) ; 

Line (Hard-Left, Exit-Botton, Hard-Right, Exit-Botton) ; 
Line (Hard-Left, Exit-Top, Hard-Right, Exit-Top) ; 
show-nouse; 
end; 

If ((x >= Left) AND (x <= Lef t-nid)) then Left-Col := TRUE else 
If ((X >= Lef t-nid) AND (x Right.nid)) then Mid-Col := TRUE else 
If ((X >= Right-nid) AND (x <: Right)) then Right-Col::: TRUE; 
if ((y >=Top) AND (y <= Top-nid)) then Top-Row : =TRUE else 
if ((y >=Top-nid) AND [y <= Botton-nid)) then Mid-Row:= TRUE; 
((y >=Botton-nid) AND (y <= botton)) then Bot-Row := TRUE; 



if 



If (Left-Col AND Top-Row AND (board (1) =0) ) then begin 
Show-MoveCXM); 
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BoardCl] := 1; 
done:= TRUE; 
end else 

If CLeft_Cal AND Mid.Rou AND Cboard[4]=8]] then begin 
Show-MoveCX', 4) : 
board[4] :=1; 
done:= TRUE; 
end else 

If tLeft_Col AND Bot_Rou AND (board 171 rO) ) then beoin 
Shou_Move ( ' X ' , 7) ; 
board!?] :=iJ 
done:= TRUE: 
end else 

If (Mid_Col AND Top_Rdu AND (board [2] =6] ] then begin 
Shou_Hove('X', 21 ; 
board[2] := 1; 
done:= TRUE; 
end else 

If (Mid-Col AND Mid.Rou AND (boardCSIzS]] then begin 
Sho«_MoveCX', 5J ; 
boardCS] :=1; 
done:= TRUE; 
end else 



If 



(Nid_Col AND Bot-Row AND (board [81 =0] 1 then begin 
Show_nove('X', 8) ; 



If 



boardlBI 1; 
done:= TRUE; 
end else 

If (Right_Col AND Top_Row AND (board [3] =8] ) then begin 
Show_nove('X', 3) ; 
board [31 :=l; 
done!; TRUE; 
end else 

(Right-Col AND Mid-Row AND (board[B]=e]) then begin 
Shou_nove( 'X', 61 ; 
board [61 !=l; 
doneir TRUE; 
end else 

If (Right_Col AND Bot_Rou AND (board [91 =81 ) then begin 
Shou_nove('X', 91 ; 
board[9] := 1; 
done:= TRUE; 
end; 

end; 

Until done OR Exit.Noughts; 
end; I of Function Get_Move } 

Procedure Conp-ftoue ( Move: integer 1; 

C Marks the conputer noue at board (novel and shows it on screen. } 
begin 

board [novel : = 2; 

Show-Move CO', novel ; 

conp_noved_sound; 
end; { of Procedure Conp-Move 1 

Function All_2(x,y,z: integerl : boolean; 

C returns true if boardfxl - boardlzl are all 2's ) 

begin 

All_2!= (board[x]r21 AND (board [y] =21 AND (board (zl =21 ; 
end; { of Function All_2 } 

Function All_l(x,y,z: integerl: boolean; 

£ returns true if boardfx] - boardiz] are all I's } 

begin 

flll_l:= (board[xl=Xl AND (boardlylzll AND (board (zl rll ; 
end; i of Function All_2 } 

Function Conp_Uins: boolean; 

C returns true if conputer wins the gane } 

begin 

Conp_Mins:= ( All_2(l, 2, 31 OR All_2(l,4, 71 OR All_2(l, 5,91 OR 
All_2(3,5,71 OR A11_2(3,G,91 OR All_2(7,8,91 OR 
All_2(2,5,81 OR All_2(4,5,61 1; 
end; ( of Function Conp-Uins } 

Function Hunan.Uins: boolean; 

( returns true if hunan wins the gane } 

begin 

Hunan_Hins:= ( AI1_1(1,2,31 OR All_l(l,4,71 OR AI1_1(1,5,91 OR 
SH-HM'IJ SS All_l(3,6,91 OR All_l(7,8,91 OR 
All_l(2,5,81 OR A1I_1(4,5,61 1; 
end; ( of Function Hunan-Mins } 

Function Two_2(x, g, z: integer; var vacant: integerl: boolean; 

t returns true if two of board[x]- boardlyl are 2's and boardtvacantl -By 

var tenp! boolean; 

begin 

tenp:= FALSE; 

If ( (board [xl =21 AND (board[y]=2) AND (board (zl =81) 
then begin 

vacant : =z; 

tenp:= TRUE; 
end 

else if ((board[x]=2) AND (boardCz]=21 AND (board (yl =81 1 
then begin 
vacant:=y; 
tenp:= TRUE; 
end 

else if ((board[y]=2] AND (board[z]=21 AND (board (xl =8] 1 
then begin 
vacant:; x; 
tenp:= TRUE; 
end; 
Two_2:= tenp; 
end; C of Function Two_2 > 

Function Two.Kx, y, z: integer; var vacant: integer]: boolean; 

{ returns true if two of board (xl- board [y] are I's and board (vacant] = 8 > 

var tenp- boolean; 

begin 

tenp:= FALSE; 
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If ( (board [x]=l) AND Cboard [yl =11 AND (board Czl =0) ) 
then begin 

vacant:=Zf 

tenp:= TRUE; 
end 

else if [(board[x]=l) AND (boardCzlrll AND (boardCylrB}] 
then begin 

vacant:=y; 

tenp:= TRUE; 
end 

else if ((board[y]=l) AND (board(z]=l] AND (boardCxl^B)) 
then begin 
vacant:^ x; 
tenp:= TRUE; 
end; 
Tuo_l:= tenp; 
end; ( of Function Tuo_l } 

Function Uin-Space (var vacant: integer!! boolean; 

C returns true if there's a space that can result in the conputer 

winning the gane. Uacant returns the space. } 
var tenp: boolean; 
begin 

tenp:= ( T«o_2(l, 2, 3, vacant! OR Tuo_2tl, 4, 7, vacant) 

OR Tuo_2(l, S, 9, vacant] OR Tuo-2 (3, S, 7, vacant) 
OR Two_2(3, 6, 9, vacant) OR Tuo_2 (7, 8, 9, vacant) 
OR Two_2(2, 5, 8, vacant) OR Two_2 (4, 5, 6, uacant) ); 

If tenp then 

if Two_2(l, 2, 3, vacant) then 
else if Twa-2 (1, 4, 7, vacant) then 
else if Tuo_2(l, 5, 9, vacant) then 
else if Tuo_2 (3, 5, 7, vacant) then 
else if Two_2(3, 6, 9, vacant) then 
else if Tuo_2(7, 8, 9, vacant) then 
else if Tuo_2(2, 5, 8, vacant) then 
else if Tuo_2 (4, 5, 6, vacant) then; 
Uin_Space : =tenp; 
end; { of Function Uin_Space > 

Function .Block_Needed(var vacant: integer): boolean; 

C returns true if the conputer needs to block a uin bg the hunan. 

vacant returns the space that nust be noved into to block. } 
var tenp: boolean; 
begin 

tenp:= C Two_l(l, 2, 3, vacant) OR Two_l(l 
Tuo_l(l, 5, 9, vacant) OR 
Tuo_l(3, e, 9, vacant) OR 
Two-l(2, 5, 8, vacant) OR 

If tenp then 

if Two_l(l, 2, 3, vacant) then 

else if Tuo_l(l, 4< 7, vacant) then 

else if Two_l(l, 5, 9, vacant) then 

else if Tuo_l(3, 5, 7, vacant) then 

else if Two-1 (3, 6, 9, vacant) then 

else if Two_l (7, 8, 9, vacant) then 

else if Tuo_l(2, 5, 8, vacant) then 

else if Tuo_l(4, 5, 6, vacant) then; 
Block-Needed :=tenp; 
end; C of Function Block-Needed } 

Function Tie_Gane: boolean; 

{ returns true if all spaces on board are occupied ) 
var i: integer; 

tenp: boolean; 
begin 

tcnp;= TRUE; 
for i:= 1 to 9 do 

if board[il=e then tenp:= FALSE; 
Tie_Gane:= tenp; 
end; C of Function Tie.Gane } 

Procedure Do_Conp_Mins; 

C does whatever should be done when the conputer wins. 

'(click nouse to continue)' nessage before new gane. 
begin 

Draw_String(184, 158, 'Conputer Wins') ; 
Correct-Sound; 
get_button; 
end; { of Procedure Do_Conp_Uins } 



4, 7, vacant] OR 
Two_l (3, 5, 7, vacant] 
Two-l(7, 8, 9, vacant) 
Two_l (4, 5, 6, vacant) 



Procedure Do_Tie_Gane; 

C does what should be done when it's a tie gane. 

'(click nouse to continue)' nessage before new gane. > 
begin 

Draw_String(124, 158, 'Tie Gane'); 
get-button; 
end; C Of Procedure Do-Tie_Gane } 

Procedure Do-Hunan-Uins; 
C hunan has won } 
begin 

Draw_String(128, 158, 'Vou Win']; 
Happy-Sound; 
get-button; 
end; ( of procedure Do_hunan-wins } 

Function Three-Moves: boolean; 
var i, j : integer; 
begin 
j :=o; 

for i :=1 to 9 do 

if boardCilOe then j:=j+l; 
Three-noues : = (j =3); 
end; C of Function Three-Moves ) 

Function Diagonals (var vacant: integer): boolean; 

( returns true if either diagonal contains two player novcs with a 
conputer nove in the center. vacant returns space to nove. > 

var tenp: boolean; 

begin 

tenp:= FALSE; 



ST-LOG JULY 1989 



75 



If three_noves then begin 

If ((board[3]=l] AND Cboard[7]=l) AND (board[SI=2)) 
then begin 
tenpJr TRUE; 

If board[6]=e then vacant:^ 6 

else if board[2]=6 then vacant:^ 2; 
end 

else If CCboardlll::!] AND (board[9]=l] AND (board [51 =2] ] 
then begin 
tenp!-TRUE; 

If board[2]=e then vacant:=2 

else if board[:6]=e then vacant:=6; 

end; 

end; 

Diagonals:^ tenp; 
end; { of Function Diagonals > 

Function Spec ial_Si t Cvar vacant: integer): boolean; 

{ returns true if any of the special situations are true, vacant 

returns the space to nove. } 
begin 

Special_Sit:=FALSE; 

If (board[51=21 AND (Three-Moves) then 
if ((board[2]=l] AND (board [91 =1) ] then 
begin 

Special-Stt:=TRUE; 
vacant:=3 
end 

else if ((board [61=1) AND (board [7] =11 ] then 
begin 

Special-Sit:=TRUEi 
vacant : =9 
end 

else if ((board[3]=l] AND (board[4]=l)] then 
begin 

Special_Sit:=TRUE; 
vacant:=l 
end 

else if ((boardCl]=ll AND (boardtSlrll) then 
begin 

Special-Sit:=TRUE; 

vacant : =7; 
end 

else if ((board[4]=l} AND (board 1:9] =1}] then 
begin 

Special_Sit:=TRUE; 

vacant:=l; 
end 

else if ((board[8]=l] AND (board [3] =1) ] then 
begin 

Special-Sit:=TRUE: 

vacant : =7; 
end 

else if ((board[8]=l} AND (board [61=1]] then 
begin 

Special_Sit:=TRIiE; 

vacant : =9; 
end; 

end; { of Function Special_Sit } 
Procedure choice.nove; 

C conputer can go in a corner or adjacent to a 1, } 

var i: integer; 

begin 

C free corner ? } 

If ((boardCllrB] and (board[9]=e]l then conp_nove(l} 
else if ((board [31 =01 and (board [71 =81 1 then conp_nDve(3) 
else if board[l]=e then conp_nove(l] 
else if board[3]=e then conp_nove(3) 
else if board[7]=B then conp_nove(7) 
else if board[9]=8 then conp_nove(9] 

C adjacent space to a 1 ? } 
else begin 
i -.-21 

uhile(board[i-l] <>l]AND(i<9) do i:=i+l: 
If (boardCil=e) then conp_nove(i) 
else begin 
i:=0; 
Repeat 

i:=i+l; 
Until (board[i]=e); 
conp_nove (i) ; 
end; 

end; 

end; { of Procedure choice_nove } 

Procedure Noughts; 
var 

vacant, x: integer; 

exit_noughts, conp_turn, harder: boolean; 
begin 

exit_noughts:= FALSE; harder:= TRUE; 
Grou-Box(118, 159, 76, 38, 8, 8, 328, 288]; 
Repeat 

Hide-Mouse; 
ScrRest(Nought_Scr] ; 

Line-Color (black) ; { outline harder or easier ) 

If harder then begin 

Line(251, 199, 382, 199) ; 

LineC2Sl, 189, 382, 189); 
end else begin 

Line(ie,189,e4,189); 

Line (16, 199, 64, 199) ; 
end; 

Shou_Mouse> 

For x:= 1 to 9 do { clear board } 

board [xl : = 8; 
Get_Move (exit_noughts, harder); 
If NOT exit.noughts then begin 



LOW RESOLUTION 



C the center is vacant } 
{ take the center } 
( take a corner > 



END 





S 





w 



{ conputer nakes nove } 



( If conputer can win, uin } 



If board[5]=8 

then conp_nove(5) 
else conp_nove(3) ; 
conp_turn:= FALSE; 
Repeat 

If conp-turn then 
begin 

conp_turn:=: FALSE; 
If Uin-SpaceCvacant] 

then conp.nove (vacant) 
else If Block_needed (vacant) ( If conp needs to block, block } 

then conp_nove(vacant] 
else If Diagonals (vacant) ( nake a good nove } 

then conp-Piove (vacant) 
else if (Special-Sit(vacant) AND harder) 

then conp_nove(vacant) 
else choice_nove; 
end 

else begin ( hunan nakes nove } 

conp_turn:= TRUE; 

Get_Move(exit_noughts, harder); 
end; 

Until Conp_Uins or Tie_Gane or exit-noughts or hunan_uins; 
If Conp-Mins then Do-Conp_Uins 
else if Tie_Gane then Do_Tie_Gane 
else if hunan_uins then do_hunan_uins; 
end; 

Until exit-noughts; 
Hide-nouse; 

ScrRest(Cupboard-Scr) ; 
Shrink-Box(B, 0, 320, 200, 118, 159, 76, 38) ; 
Shou-nouse; 
end; < of Procedure Noughts } 

Function Main-Menu: Integer; 
{ Gets input fron nain screen. 

Returns: l=Repeat, 2=Eight ball, 3=Noughts, 4=Exit-Gane. } 
Const 

88; ( These define the shelves of the cupboard > 
118; 
124; 
154; 
159; 

189; 
118; 
194; 
184; 
194; 
241; 
282; 



Rpt-Top 

Rpt-Botton 

Eight-Top 

Eight-BottoM 

Nought-Top 

Nought-Botton 

Left 

Right 

Exit-Top 

Exit_Botton 

Exit-Left 

Exit-Right 



War 

done: boolean; 
X, y: integer; 
begin 

done:= FALSE; 
Repeat 

Main-Event (108) ; 

If button then begin { check to see if iten selected } 
x:= Mouse-x; 
y:= Mouse-g; 

If ((x >= Left) AND (x <= Right)) then 

If ((g >- Rpt-Top) AND (y <- Rpt-Botton)) then begin 
done:= TRUE; 
Main-Menu:= 1; 
end else 

If ((g >= Eight-Top) AND (g <= E ight-Botton) ) then begin 

done:= TRUE; 

Main-Menu := 2; 
end else 

if ((y >= Nought-Top] AND (y <- Nought-Botton)) then begin 

done:= TRUE; 

Main-nenu : = 3; 
end; 

If ((x >= Exit-Left) AND (x <= Exit-Right) AND (y >= Exit-Top) 

AND (y <= Exit-Botton)] 
then begin 

done:=TRUE; 

Main-Menu := 4; 
end; 

end; 
Until done; 
end; C of Function Main-Menu > 

Procedure Main-Loop; 

C This is the nain loop which calls all of the other routines ) 
var 

picked: integer; 
begin 
Repeat 

picked:= Main-Menu; 
case picked of 
1: Repeat-Gane; 
2: Eight-Ball; 
3: Noughts; 
4: Get-Out; 
end; 

Until Exit-Gane; 
end; { of procedure Main-Loop } 



begin 

If Init-Gen>=0 then begin 

Initialize; 

Main-Loop; 

Exit-Gen; 
end; 
end . 
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REVIEW 



LDW Power 



Logical Design Works 

780 Montague Expressway 

Suite 403 

San Jose, CA 95131 
(408) 435-1445 

$79.95, high and medium resolution 



lf\ Hnrksheet Range Copy-Hove File Print Eft!!! Data Hacro Quit 
[^ BflHlsIinbols Both Neither 



an amazing computer when consider- 
ing its price and, recently, its soft- 
ware library. The most popular 
MS-DOS database, dBase III Plus, 
runs on the ST under dBMan. And 
recently, the most popular MS- 
DOS spreadsheet, Lotus 1-2-3 (Ver- 
sion 2), runs on the ST under the 
new LDW Power spreadsheet. 

While Logical Design Works 
(LDW) might want to shy away 
from calling its product a Lotus 
1-2-3 clone (think of how Lotus' 
lawyers might react), LDW Pow- 
er is an exact replica of that MS- 
DOS spreadsheet. The two pro- 
grams are so similar that you can 
take data and macro programs 
from the PC to the ST and vice 
versa. And the ST version runs 
more than twice as fast. 

This could provide quite an im- 
provement in the ST's standing 
among the business executives 
who have snubbed the ST in the 
past. Imagine a purchasing agent 
trying to decide between the pur- 
chase of a $2,500 basic MS-DOS 
computer clone, versus the price 
of a $1,300 ST computer. The sav- 
ings in the software library are just 
as dramatic: the latest version of 
Lotus 1-2-3 is sold in Computer- 
land stores for $340 with LDW 
Power, holding a list price of only 
$79.95. The street price of LDW 
Power is even lower. 



Connect data points Hith lines 




13. 4>: 16.72 DM 

25. OX 23.57 DM 

7.0/. 9.19 DM 

21. 6>: 20.43 DM 

19. 3>^ 22.10 DM 

13.8/. 13.93 DM 



Previously, ST owners looking 
for a Lotus 1-2-3 platfo n had to 
purchase VIP Professional at 
$249.95. In its time, VIP Profession- 
al was a good workhorse. ST users 
could use VIPs many Lotus- 
compatible commands without 
having to learn a completely new 
system. But, while VIP Profession- 
al was a powerful program, it did 
not support features built into the 
more recent versions of Lotus 
1-2-3. LDW Power does. 

How do you 
measure a 
spreadsheet? 

Spreadsheets are most easily 
compared in terms of size. LDW 
Power has a small spreadsheet. 



8,192 rows by 256 columns, com- 
pared to its MS-DOS look-alike. 
Don't worry; although some Lotus 
aficionados might think this is a 
small spreadsheet, it should suffice 
for just about every ST application. 

A possible reason for the size of 
the spreadsheet is the huge size 
of the program. Lotus 1-2-3 has 
evolved into a powerful piece of 
software. By modeling LDW Power 
after Lotus, the programmers have 
had to create a program that sup- 
ports graphics, database functions, 
a macro-command language and 
support the mouse/window/menu 
system of GEM. 

LDW Power makes full use of 
the ST's capabilities. The fast 
processing speed of the ST gives 
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this program a great advantage 
over Lotus running on an IBM PC 
or AT computer. The easiest way 
to see the speed improvements is 
to scroll around a fairly complex 
worksheet. Using a worksheet 20 
columns wide and 20 rows tall, 
LDW Power blazes through the 
columns left-to-right and rolls the 
worksheet extremely fast, com- 
pared to the same simple functions 
on the MS-DOS machine. When 
the worksheet Is expanded to 100 
columns by 100 rows, the scroll 
speed does not appreciably slow 
down. 

Recalculation speed, also, 
seems to stay fairly constant 
throughout several tests. Using the 
Savage Benchmark test {BYTE, 
June 1987), LDW Power processed 



current state of the spreadsheet 
market. LDW Power is superior in 
so many ways to its competition: 
speed, functions, ease-of-use, 
macros, compatibility and printer 
support. So the issues of GEM 
usage, unusual functions and 
uniqueness are important in a fair 
comparison. 

For example, while LDW Pow- 
er does everything under the sun 
at extremely fast speeds, it does 
not work on a 520 ST without a 
memory upgrade. Once the 345K 
program is loaded, several memory 
buffers are established, and the 
worksheet window appears. There 
is only enough memory on a 520 
system for 85 cells. 

In addition, LDW Power is disk 
hungry. During several trial runs. 
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1,000 iterations of a complex 
mathematical formula in 39 sec- 
onds. The same test using Lotus 
1-2-3 on an IBM PC finished in 210 
seconds. 

The measure of an 
ST application 

LDW Power delivers the pow- 
er, speed and compatibility of its 
MS-DOS twin. But just how good 
is it to use on the ST? How good 
a program "feels" on its host com- 
puter can make or break a product. 
An understanding oi LDW Power's 
other functions is Important before 
making a software purchase. 

Comparing LDW Power to the 
other ST spreadsheets does not 
yield a good understanding of the 



worksheet files containing less 
than 100 cells occupied more than 
5K of disk storage. The Savage 
Benchmark, which used 1,000 
cells, required 120K of storage. 
LDW Power really needs a hard 
disk drive to be useful to the pow- 
er user. 

The programming design behind 
LDW Power is refreshing. The pro- 
gram is of the everything-fits-in- 
memory variety. Once loaded, the 
program diskette may be removed 
and a data disk inserted. 

The minimum hardware setup 
for LDW Power should be a 1040 
ST system with one double-sided 
disk drive. ST users who frequent- 
ly switch between programs- 
word processor to spreadsheet. 



etc.— should have a hard disk to 
use LDW Power since the program 
is so large, making it impractical 
to use one of the program switch- 
ers, like Juggler. 

Once running, the program 
offers few disk-manipulation com- 
mands. A file-delete function is 
available, but LDW Power lacks a 
file copy, initialize disk and file 
move functions. Power is compat- 
ible with the Universal Item Selec- 
tor, a commercially available 
file-selector alternative that pro- 
vides all these missing functions. 

The loolc and feel 

A program of this size should 
feel comfortable to use. Since each 
ST owner has a different style of 
usage, the program should con- 
form to the user. But, most of the 
time, this happens in reverse. For- 
tunately, LDW Power has several 
subtle features that make it very 
easy to use. 

Upon exiting LDW Power, a 
special file is stored to keep the 
user settings established during 
the work session. For example, 
once the default file directory of 
a hard disk has been established, 
LDW Power saves a special file, 
LDW.CNF, to be read the next time 
the program is used. This is one 
of those nice extras that makes a 
piece of software more comfort- 
able to use, but one that is often 
overlooked. 

For LDW Power users that work 
with one spreadsheet most of the 
time, any worksheet titled 
AUTO.LDW will be automatically 
loaded when LDW Power is first 
started. 

The mouse can be used to 
select a range of cells for an oper- 
ation, incorporating the classic 
"click and drag" to determine the 
range. If the range extends outside 
of the current window size of the 
worksheet, the window automat- 
ically scrolls in the needed direc- 
tion to show the extended drag 
region. This function works in 
reverse, as well. 

The layout of the screen is com- 
fortable: the usual bag of GEM 
tricks, with a few new controls to 
add a little spice. The menu bar is 
designed to emulate Lotus 1-2-3 
Circular menus. The Quit entry is 
a drop-down menu title on the 



right of the screen. Since most ST 
users expect Quit to be the last 
entry in the File drop-down menu, 
it might take a little getting used 
to, but the menu layout is skillfully 
designed. 

Lotus 1-2-3 does not have the 
GEM system to draw from, so 
each command is keyboard driven, 
although, just recently, versions of 
Lotus have appeared that lightly 
support a mouse and windowing 
system. The keyboard menu com- 
mands all begin with the "/" 
character. Pressing the "/" key in 
LDW power activates the menu 
bar. Each menu entry uses a 
separate keyboard equivalent, 
usually the first letter of the func- 
tion. For example, pressing "/Q" 
quits LDW Power. Pressing "IP" 



Lotus 1-2*3 dees 
not have the GEM 
system to draw 
from, so each com- 
mand is keyboard 
driven, although, 
|ust recently, ver- 
sions of tofvs have 
appeared that light- 
ly support a mouse 
and windowing 
system. 



prints the worksheet. 

LDW Power is uniquely good at 
supporting the keyboard and 
mouse. After pressing the "/" key, 
the mouse can also be used to 
click on the desired menu function. 
In fact, the mouse and keyboard 
can be used interchangeably at 
any time. The left mouse button 
selects a function, while the right 
mouse button is the equivalent of 
pressing the Return key First-time 
users will spend an hour getting 
used to the new system. 

Directly beneath the menu bar 
is a row of eight command but- 
tons. Lotus users comfortable with 
using the keyboard will find the 
command buttons an easy method 
of accessing all of LDW Power's 
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commands. ST users who rely on 
the mouse will most likely not use 
the command buttons, as their 
drop-down menu equivalents are 
always available in the usual GEM 
menu bar. 

One of the command buttons, 
SCRL, puts LDW Power into scroll 
mode. When active, the worksheet 
can be scrolled up/down and left/ 
right using the arrow keys. This 
function isn't needed by mouse 
users, as the worksheet window 
has the usual GEM horizontal and 
vertical slider bars. 

LDW Power works with desk 
accessories, so it is also possible 
to use a calculator or other sup- 
porting program. The LDW Power 
windows can be dragged and 
sized; however, the desktop area 



Printing a report 
witii LDW Power is 
not a simple function. 
Since tiiere ore so 
many options, a 
good read tiirough 
tiie manual is 
needed before the 
novice user will feel 
comfortable. 



of GEM has been reduced to pre- 
vent LDW Power windows from 
being dragged over the command 
buttons. This feature reduces the 
amount of screen display area to 
14 rows of worksheet data. It 
would have been better to allow 
the command button area to be 
covered, if so desired. To help 
make up for this. Monochrome ST 
computers can use a condensed 
type style that displays 29 rows of 
worksheet data; however, many 
users will find the condensed 
screen font straining on the eyes. 

Last year proved to be the year 
of the accessory. When testing 
LDW Power, Turbo ST greatly in- 
creased the overall display speed. 
Turbo ST is a software blitter emu- 



lator that improves the screen 
drawing speed of GEM. In addition, 
G+Plus improved LDW Power's 
speed when printing drawings to 
a GDOS-compatible printer. 
G+Plus is a replacement for 
Atari's GDOS operating system 
software. Both products are good 
investments when using LDW 
Power, however, they both rob the 
LDW Power worksheet of valua- 
ble memory space. 

The look of a worksheet can be 
enhanced by using some of GEM's 
text effects. Bold and underline 
can be used to highlight important 
areas of a spreadsheet. 

The one noteworthy feature 
missing from LDW Power is the 
ability to correct mistakes made 
using the program's functions. The 
ST keyboard has an Undo key, but 
few ST program support its use. 
In theory, every GEM program 
should be able to reverse the ef- 
fects of the last command. For 
some unknown reason, LDW Pow- 
er skipped this important feature. 

Macros and 
functions 

At first glance, a spreadsheet 
appears to be a monomaniacal 
program. Its sole purpose is to 
crunch numbers using a metaphor 
established by accountants: the 
worksheet. Macros and functions 
make a spreadsheet much more 
than a simple computerized ver- 
sion of an accountant's pencil- 
pushing task. Functions allow data 
to be tested, and the results of the 
test can alter the contents of the 
worksheet or additional spread- 
sheet functions. Macros make it 
possible for the spreadsheet to 
learn about and analyze the infor- 
mation that is entered into the 
worksheet. 

Suppose the spreadsheet is 
used to enter real-estate informa- 
tion into an ST computer. Since 
computer unsophisticates are usu- 
ally used for data entry, the result- 
ing precision of the work can leave 
much to be desired. Using a 
spreadsheet macro, the data en- 
tered can be tested against pre- 
determined values. If the data 
entered is bad, the data-entry per- 
son can be alerted and asked to 
enter the information again. 

Suppose Column A of a spread- 



sheet is used to enter a series of 
dollar amounts for houses locat- 
ed in a suburban area of Dallas. 
The real-estate agency using the 
spreadsheet has determined that 
houses costing less than 20% of 
the average of the other homes 
entered is a bad risk. After enter- 
ing the house values, the agency 
manager wants to see a list of the 
good and bad homes. To makes 
this work, Column A is established 
to receive the name of the house. 
Column B holds the price, and 
Column C displays a GOOD or BAD 
indicator. 

Column C displays the word 
GOOD or BAD if the average of the 
first ten lines of Column B is 20% 
higher than the last entered home 
value. Column C's formula contains 



macro is played back, the user 
sees the worksheet cursor move 
through the functions that were 
previously recorded. A macro used 
in the home-pricing example 
moves the cursor from one row to 
another, allowing the user to enter 
a home value. The last macro 
command might produce the print- 
ed report requested by the office 
manager. 

Reports are 
complex 

Printing a report with LDW 
Power is not a simple function. 
Since there are so many options, 
a good read through the manual is 
needed before the novice user will 
feel comfortable. 

Like Lotus 1-2-3, the report- 
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the following expression: 

GIF (GAVG(B2..Bie) ) Bi«1.2e, "SAD", "GOOD") 

The IF function tests the first 
expression, AVG, and yields either 
a GOOD text value if the average 
is greater than the house or a BAD 
text value if the average is less 
than or equal. LDW Power has a 
large library of functions, making 
it easy to create complex, intelli- 
gent worksheets. 

The IF function used in this ex- 
ample works on one cell at a time. 
Macros automate functions by 
creating a template of commands. 
The macro function works like a 
tape recorder. When recording a 
macro, the mouse or keyboard is 
used to move through the work- 
sheet and call functions. When a 



writing capabilities are strong in 
comparison to other ST spread- 
sheets. Options include customized 
headers and footers, page number- 
ing with date and time tags, ad- 
justable margins and borders, 
user-definable page length and 
alignment, etc. All selected print 
format commands are saved with 
the worksheet. 

The program supports GDOS, 
assuring what-you-see-is-what- 
you-get output when using a 
GDOS-compatible printer. The list 
of GDOS printer drivers is short, so 
be sure to check with LDW for 
printer compatibility before buying. 
LDW Power uses a straightfor- 
ward ASCII printer driver to print 
the contents of a worksheet. 
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The user can choose output to be 
sent to the parallel or serial con- 
nectors of the ST. Line feeds can 
be included with carriage return 
characters, making it compatible 
with IBM printers. Output can also 
be sent to a disk file, for later 
modification using a word 
processor. 

A special utility is included that 
allows LOW Power to print work- 
sheets and other ASCII files at a 
90 degree angle. The equivalent 
program in the MS-DOS world is 
called Sideways. The LOW utility 
allows spreadsheets wider than 
the standard SVixll-inch piece of 
paper This is a must for business 
users. 



formation into LOW Power is in 
the disk drives. The information 
has to at some point be put onto 
a SVi-inch floppy drive. Most new 
IBM computers are being shipped 
with 3 '/2 -inch and 5 ^ -inch flop- 
py drives, but if your equipment 
doesn't have this capability, try 
contacting a local IBM dealer. 
They usually will copy Lotus files 
onto a 3'/2 -inch disk at no charge. 

LOW Power supports mass im- 
port of text and numbers from 
non-/.DM/fbwe/- files, the data be- 
ing loaded into the worksheet as 
text labels. The database functions 
can later be used to separate the 
imported data into rows and 
columns. A similar system can be 
used with raw numeric data. 
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Communicating 
with the rest 
of the world 

One of LOW Power's biggest 
features is the ability to directly 
load Lotus worksheets and mac- 
ros. MS-DOS users that are 
equipped with SVi-inch floppy disk 
drives are in luck. Since the ST 
floppy diskettes are directly com- 
patible with IBM's disk format, to 
load a Lotus .WK1 file into LOW 
Power is as simple as inserting the 
diskette into your ST drive, and 
selecting Retrieve from the File 
drop-down menu. LOW Power 
takes care of the translation and 
promptly displays the Lotus file. 

The key to getting the Lotus in- 



Hopefully, LOW will eventually 
release a utility program that im- 
ports and exports data from sev- 
eral other formats: delimited, SILK, 
DIF, etc. 

Of course, worksheet informa- 
tion may be stored to a disk file. 
In addition, LOW Power has sever- 
al sophisticated commands that al- 
low portions of a worksheet to be 
merged with other worksheets. 
Complex worksheets can use data 
contained in external worksheets, 
a handy function when the maxi- 
mum number of cells is reached. 

Worksheets can be secured 
with the use of a password, up to 
15 characters long. A-Calc Prime 
is the only other ST spreadsheet 



to support password protection, a 
feature necessary when selling 
spreadsheet software to govern- 
ment institutions or the Fortune 
500. 

A word on support 

The word is "good." Overall, 
LOW has supported the ST com- 
munity with technical support, 
dealer support, software upgrades 
and decent documentation, and 
the company seems to draw 
enough revenue from Europe to 
make a good run of its U.S. opera- 
tions. LOW has been visible at the 
latest trade shows and appears 
have a good future ahead. 

The LOW Power manual is ade- 
quate to show you the ropes; 
however, overall, the documenta- 
tion is only fair The text is infor- 
mative as a reference, but more 
pictures and illustrations are need- 
ed. Luckily, since Lotus 1-2-3 has 
such an established name, most 
book stores carry a complete sec- 
tion of tutorials, primers and other 
reference books that, due to its 
similarity to Lotus, also apply to 
LOW Power. 

LDW's technical support is first 
rate. You can reach them at their 
San Jose, California offices week- 
days during business hours. 

Conclusion 

If you're looking for a spread- 
sheet program that'll give you not 
only the power of Lotus 1-2-3, but 
also compatibility with that pop- 
ular program, then you need look 
no further than LOW Power. ■ 




Frank Cohen regularly contrib- 
utes to ST-LOG and ANALOG. His 
experience witli Atari computers 
stretches back to his first com- 
mercial product Clowns & Bal- 
loons. He may be contacted on 
CompuServe (76004,15731 and 
GEnie (FCOHEN), or directly at P.O. 
Box 14628, Long Beach, CA 
90803-1208. 
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Paint packages such as Electronic Arts's DE- 
GAS Elite and Atari's Neochrome 
have done well and have been 
used to create a remarkable vari- 
ety of art. These packages have 
one major limitation however: 
They can create only graphics with 
the same resolution as the screen. 
DEGAS Elite thus has a limit of 
640x400 in monochrome mode, or 
about 80 dpi. Most printers are 
capable of higher resolution 
however— from about 100 dpi for 
inexpensive 9-pin dot-matrix 
printers, up to 300 dpi for laser 
printers and the H-P Deskjet. 

There is a popular file format, 
an "image" file, which supports 
such high resolutions. These files 
generally have an extender of .IMG 
and can be in virtually any resolu- 
tion. Most desktop publishing 
packages, as well as Migraph's 
Easy Draw, can import and use 
.IMG files. However, except for a 
few scanners and some commer- 
cial clip art, there has not been any 
source of .IMG files, and no way 
to edit the few that were available. 
That has all changed with the in- 



troduction of Touch-Up, the high 
resolution graphics editor from 
Migraph. 

Touch-Up's main screen con- 
sists of a working window, a tool 
panel on the left side of the screen 
and a complete set of drop-down 
menus. The working area shows 
the graphic you are working on. 
Since the resolution of the graph- 
ic can be far higher than what can 
be shown on the screen, Touch- 
Up compensates by showing the 
graphic larger than full size, and 
the graphic can cover many 
screens, provided you have the 
memory available. The working 
area can be scrolled just like any 
window, using the scroll bars to 
reach the part of your picture you 
want to work on. You can also 
scroll by clicking and dragging the 
"locator," a black box that 
represents what you can see on 
the screen within a white box that 
represents the whole graphic. 

The tool panel is normally fixed 
to the left side of the screen, but 
it can be hidden to provide a larg- 
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er workmg surface or detached 
into a window of its own, so that 
it can be relocated on the screen. 
It is often advantageous to hide the 
tool panel, since many of its func- 
tions are duplicated in the drop- 
down menus. As is normal for 
such programs, all drawing is done 
with the mouse. A variety of draw- 
ing tools are available, including 
box, circle, polyline, arcs, freehand 
sketch and splines. Upon select- 
ing the box or circle, a box or cir- 
cle appears instead of the mouse 
cursor, in whatever was the last 
size you used. You can resize the 
brush by moving the mouse with 
the left button pressed. The brush 
moves with the mouse until you 
press the right button (as in Easy 
Draw) to paste the brush down. 
When the brush is pasted down, 
it is then drawn with the current 
line style and fill. 

Splines are an interesting and 
powerful tool. A spline is a curve 
that attempts to follow a series of 
control points, which you lay down 
by clicking the mouse's left but- 
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ton. Before transforming the spline 
into a brush, you can edit the con- 
trol points (remove or move them). 
Once you have created a brush 
with the spline, you can still edit 
points, using the keys and mouse. 
Even the "goodness of fit" (how 
closely the spline tries to pass 
through your specified control 
points) is user-adjustable. 

Special-effect and user-defin- 
able settings abound in Touch-Up. 
The line width and end type (ar- 
rows or plain), as well as whether 
edges are drawn for filled shapes, 
can be set. Eight different shadow 
offset directions can be chosen, 
and the offset for the shadow can 
be selected as well. Four different 
"writing modes" can be used to 
create some special effects: 
replace, XOR, transparent and 
reverse transparent. All 36 GEM 
patterns can be used for fills; 
however, there is no user-defined 
pattern. Four zoom magnifications 
are available ranging from full (you 
can see the whole page represent- 
ed on the screen) up to four times 
normal. 

Touch-Up's "lightning" mode 
gives you access to only the cur- 
rently visible screen (no scrolling 
to other parts of the diagram). 
However, any changes you make 
in lightning mode are automatically 
transferred to the main diagram 
when you exit. 

There are quite a few advan- 
tages to working in the lightning 
mode. First of all, there is an Undo 
feature, which is missing from the 
regular mode (and sorely missed). 
You can Undo the last action or all 
changes made since entering 
lightning mode. Then there are the 
additional drawing tools. An air- 
brush is available, which can be 
square or circular, in one of three 
sizes. The maximum saturation of 
the brush can be set, as can the 
fill speed. You can also decide to 
use the current pattern for the fill. 

Another new tool is the "fat 
bits" mode, which provides a small 
portion of the screen in extreme 
magnification, so that you can 
work on individual dots. Lasso is 
another useful tool. With it, you 
can lasso just about any portion of 
the picture and start using it as 
your current brush. 

The resizable clip rectangle pro- 



vides still more options. Once it 
has been specified, it allows you 
to move or copy whatever it sur- 
rounds to another place in the di- 
agram. Its contents can also be 
saved to and loaded from disk, 
providing a rudimentary clipboard 
capability. Besides using .IMG files, 
the clip area can be saved as a DE- 
GAS, MacPaint, GIF, PCX, TIF or 
IFF-ILBM files. You may load most 
of these files into the clip area as 
well. 

A utility provided with Touch-Up 
can convert PrintMaster files to 
.IMG files and back again. Thus, 
Touch-Up can edit and save Print- 
Master files— a significant plus. 
The clip area can also load .GEM 
files from programs such as Easy 
Draw, unfortunately, the text is not 
loaded, and therefore is lost. This 
is too bad because many .GEM 
files include text. This is rather 
a serious limitation. 

The contents of the clip rectan- 
gle can be mirrored, flipped, slant- 
ed and rotated. Three other special 
effects are also available— Cleanup 
(removes stray dots). Outline (re- 
moves fill patterns, leaving just the 
shape outline) and Mask (creates 
special effects using fill patterns, 
generally to lighten them). Finally, 
you can use the image viewer to 
look at any .IMG file on the disk 
without loading it, and even set 
the clip rectangle to be the proper 
size so that you can then load it 
without distortion. 

Touch-Up does text. It comes 
complete with ten special fonts, all 
of which can be set to be any size 
from too small to read up to 999 
dots (not points) high. Various at- 
tributes, such as underlined, bold, 
slanted, italic, fat, outlined and 
filled can be specified. Filled is es- 
pecially powerful, since the letters 
will be filled with the current fill 
pattern. 

Using text is somewhat awk- 
ward however. You must specify 
the size and attributes, then click 
on an icon that lets you type up 
to 35 characters into a dialog box. 
Once you have done this, you 
move the cursor onto the draw- 
ing area and click the left button, 
which will bring up a box that is 
roughly (very roughly) the size of 
the text string. Clicking the right 
button then pastes the text down 



and draws the letters. It's not a 
word processor, but it does work. 

Although Touch-Up produces 
only black-and-white pictures, it 
can import color pictures, convert- 
ing them into black and white. 
There are a variety of algorithms 
you can use for this conversion, 
ranging from simple (quick and 
dirty) to 4x4 table mapping, where 
each color is mapped to a differ- 
ent 4x4 grid pattern. The latter 
takes awhile, and you can end up 
with a big image file (takes up lots 
of memory and disk space). The 
results are remarkable, however, 
especially at 300 dpi on a laser 
printer. 

Touch-Up is flexible when set- 
ting up an image. A dialog box al- 
lows setting the size of the image 
(in pixels, centimeters or inches), 
the size and location of the clip 
rectangle (although it's easier just 
to drag it where you need it) and 
the resolution in either dpi or pix- 
el size. Unfortunately, the manual 
is incorrect on how to set the pixel 
size. You cannot simply type in the 
numbers you want and click on 
OK. You must first click on the DPI 
button (even if it is highlighted al- 
ready] or your adjustments will be 
ignored. 

Speaking of the manual, in 
general, it's well written, although 
slightly disorganized. There are 
sections (as noted in the previous 
paragraph) where explanations are 
wrong, as if the person writing the 
documentation didn't get a chance 
to test it against the final product. 
There are also inconsistencies in 
the product itself. For example, 
when drawing boxes in regular 
mode, you get rounded corners by 
holding the Shift key However, 
when drawing boxes in the light- 
ning mode, you must press the 
Alternate-R toggle to get the 
rounded corners. Why should 
these be different? There are also 
instances where two similar ac- 
tions are not selected the same 
way Such anomalies are not seri- 
ous, but are annoying, since you 
must drag out the (indexless) 
manual to try to figure out how to 
perform the task. 

Touch-Up's disks are not pro- 
tected, and it runs just fine from 
a hard drive. However, Migraph 
has been hurt by piracy and so has 



taken the rather drastic step of 
providing a hardware "key" that 
must be plugged into the printer 
port. While some may be irritated 
at having to pay for such a thing 
(keys are not cheap, that's why 
many manufacturers do not use 
them), my reaction is that if this 
is what it takes for Migraph to 
continue to provide the excellent 
software (and this includes Touch- 
Up] they have in the past, it is a 
small price to pay 

Touch-Up is a GDOS application 
and comes with several utility pro- 
grams that are useful. First, there's 
OUTPRINT, which can print any 
.IMG file. It is the same program 
provided with Easy Draw. Since a 
small .GEM file must be present 
for OUTPRINT to work, you can- 
not print an .IMG file until it has 
been loaded into Touch-Up and 
saved again. As mentioned earli- 
er, a program for converting Print- 
Master libraries to .IMG files is 
also provided, which makes it easy 
to use PrintMaster icons in your 
desktop-publishing files. Lastly, a 
utility that speeds up your mouse 
is included. Touch-Up is complete- 
ly compatible with G+Plus from 
CodeHead software, but is not 
compatible with Turbo ST from 
Softrek {Turbo 57" fouls up the flip 
and rotate functions of the clip 
area— at least). 

Touch-Up is a powerful drawing 
package that can handle .IMG files, 
as well as many popular graphics 
formats. Because of this power, 
you will need to spend some time 
learning to use the program, but 
the time spent will be well worth 
the effort. This program is highly 
recommended.. 




David Plotkia has been pound- 
ing the tej/s on Atari computers 
for almost ten years, and in that 
time he has written many 
memorable programs and articles 
He has an MS in chemical en- 
gineering and is a data analyst for 
Chevron Corporation. 



ST-LOG JULY 1989 



83 



Reviewed 
by 

David Piotkin 




Prospero Pascal 

Prospero Software 
100 Commercial Street 
Suite 306 

Portland, Maine 04101 
(207) 874-0382 
$149.00 




Prospero Pascal is a 
full-featured Pascal that 
includes everything you need 
to begin writing stand-alone 
programs for your Atari ST. 



Pascal is the language of choice for many 

programmers of the Atari ST, as 
well as many other computers. 
Pascal is a structured language 
that makes it easier to follow pro- 
gram logic and avoid the pitfalls of 
"spaghetti coding." The results of 
a Pascal program are compiled to 
machine language, and can thus 
run quickly, as well as be market- 
ed commercially or handed out to 
people who don't own a copy of 
the language. 

Prospero Pascal is a full- 
featured Pascal that includes 
everything you need to begin writ- 
ing stand-alone programs for your 
Atari ST In addition to the lan- 
guage and associated libraries. Pro 
Pascal includes a symbolic debug- 
ger, cross-reference variable gen- 
erator and "library manager" to 
help programmers who wish to 
maintain their own libraries. 

Working on 
the workbench 

Pro Pascal is operated from a 
shell known as the "workbench." 
Fully menu-driven, the workbench 



gives you access to a full-function 
editor with many advanced capa- 
bilities, the compiler and linker. You 
may also run a program straight 
from the workbench, so you can 
test the results of your programs 
without exiting Pro Pascal. Quite 
a variety of configuration options 
can be specified and saved to disk 
for future sessions. 

The editor can load a .PAS file 
(or any other file, for that matter) 
and runs in a window with scroll 
bars, arrows and the usual GEM 
controls. The full features of the 
editor make it a straightforward 
task to edit your file. You can 
specify blocks of text using the 
mouse (full click-and-drag), and 
once you have done that, you can 
cut, copy, paste, delete or write 
the block to disk. You can also load 
a block from disk, giving the capa- 
bility for merging different program 
fragments. The editor supports 
find and replace (both forward and 
backward), auto-indenting loops 
and decision statements, and can 
instantly jump to any line number. 
Even the common WordStar com- 



84 



ST-LOG JULY 1989 



mand keys for moving the cursor 
are supported. Finally, the function 
keys can be defined to produce 
just about any string you desire, 
giving you full macro capabilities. 

The compiler converts the Pas- 
cal source code to relocatable 
machine language. It is fast, yield- 
ing compilation times comparable 
to OSS/ICb's Personal Pascal 
compiler. One of the things that 
makes the compiler so flexible is 
the ability to specify the drive and 
path from which include files, 
work files and libraries will be 
read from or written to. The com- 
piler has a separate option to do 
a syntax check on the source 
code that is handy and much 
faster than attempting to do a 
complete compile, only to find 
many syntax errors. Many com- 
piler options allow you to cus- 
tomize what you want the 
compiler to do. Checking (arrays, 
assignments and pointers) is 
recommended during program de- 
velopment, these can be turned 
off for the final compile to produce 
faster code. Double precision can 
be used for real numbers, and you 
can ask for shorter (but slower) 
code generation. 

The linker links the machine 
language output from the compil- 
er with the files necessary for the 
program to run. The workbench 
offers the option of linking with 
files necessary for running under 
GEMDOS and GEM (VDI and AES), 
as well as any other files you 
desire. The linker can be used 
with a control file that lists the 
names of all files that are to be 
linked, which provides quite a bit 
of flexibility 

Also included with the work- 
bench is PROBE, the symbolic 
debugger. This advanced program 
tests a program and can be in- 
valuable in finding errors. The out- 
put of PROBE can be routed to a 
file, the printer or an alternate 
screen. A cross-reference gener- 
ator that compiles a list of all vari- 
ables (called "source identifiers" 
in the Pro Pascal documentation) 
is available. It can even list the 
variables in any included files and 
show what line these variables 
are used on. 



Pro Pascal is a complete Pascal, 
meeting not only the ANSI stan- 
dards, but also containing many of 
the "normal" extensions users 
have come to expect. Full variable 
typing, including integer, real, char. 
Boolean, enumerated, subrange, 
array, record, set, pointer and files 
are all supported: The files can be 
either text or nontext, and random- 
access files are also available. 
Procedures and functions, with 
both variable and value parameters 
are provided, as is CASE, REPEAT 
WHILE, FOR, WITH and IR The 
standard set of math functions, 
commands to input and output 
text, string handling. Boolean 
(AND, OR, XOR), set operations and 
bit/byte manipulation are all built 
into Pro Pascal. Even in-line as- 
sembly code is supported. 

As with any other version of 
Pascal, all variables have to be 
declared, but there is no limit on 
the number of times the CONST 
or VAR declarative headers can be 
used. Segment compiling is sup- 
ported; that is, procedures and 
functions can be grouped into a 
segment or module and compiled 
separately. By then including the 
compiled code in the final product 
(using the EXTERNAL directive), 
you are freed from having to 
recompile the (assumed to be) 
error-free sections of your pro- 
gram over and over, thus saving 
time and increasing the ease of 
debugging because the program 
in the editor will be shorter, since 
it need not include the segment- 
compiled portions. 

Full array support includes the 
Pascal extension to denote an ar- 
ray as either "ARRAY[t1] of AR- 
RAY[t2] of t" or "ARRAY[t1, t2] of 
t," making it conform to the more 
"normal" notation of arrays. 
Record types include variant tag 
fields. String manipulation func- 
tions include CONCAX COPY, IN- 
SERT, LENGTH, DELETE, STR and 
POS, making string handling a 
powerful part of this language. 
File-handling command extensions 
include assigning a file to a device 
(handy for printing), variable buffer 
sizing, RAMdisk support, append- 
ing to a file, updating (both read 



and write access) and full random- 
access text and nontext files. 

Pro Pascal also contains com- 
mands supporting GEMDOS's abil- 
ity to allow one executing program 
to invoke another, complete with 
message passing and return 
codes. Although these advanced 
concepts will not be of use to the 
majority of programmers, they per- 
mit the developer to include 
powerful capabilities in their Pro 
Pascal programs. Finally Pro Pas- 
cal has extensions for hyperbolic 
trig functions, Peek, Poke, address 
of variables, a prompt function, 
date and time. 

A reel! GEM 

Pro Pascal includes a full range 
of support for both VDI and AES, 
in the form of external procedures 
that match, almost exactly the for- 
mat of VDI and AES calls in C. This 
similarity makes it possible for 
someone who is just learning how 
the GEM functions work to make 
use of the large amount of infor- 
mation available about the C GEM 
calls. In your Pascal program, you 
must include the file that declares 
the special Pascal parameters and 
arrays, then link the file that con- 
tains the external procedures 
themselves. Virtually every VDI 
and AES function is included, in- 
cluding all graphics, menus, dialog 
boxes, windows and events. Each 
function is accompanied by a com- 
plete explanation of how it works, 
example programs and a declara- 
tion of the external procedure or 
function. 



The three manuals that accom- 
pany Pro Pascal are high-quality 
and spiral-bound to allow them to 
lie flat. They are not designed to 
teach programming in Pascal, but 
are excellent reference guides. The 
first manual is on the language and 
the workbench (editor, compiler, 
linker) and includes a full descrip- 
tion of the extensions to the lan- 
guage. The two additional 
manuals, describing the VDI and 
AES extensions, are complete, and 
little additional information on 
GEM should be needed beyond 
what is supplied. 



Comparisons 

Inevitably, comparisons will be 
drawn between Pro Pascal and the 
giant of the ST Pascal world. Per- 
sonal Pascal from OSS/ICD. Both of 
these languages are excellent im- 
plementations of Pascal, but they 
are quite different, especially in how 
they handle GEM. Pro Pascal uses 
the straight "generic" VDI and AES 
bindings, while Personal Pascal has 
its own functions that combine some 
of the more tedious GEM bindings 
into more powerful (and easier to 
use) commands. Personal Pascal al- 
lows you to build your own Dialog 
boxes and menus right in the pro- 
gram. It also automates much of the 
handling of windows and gives ex- 
cellent descriptions and sample pro- 
grams showing how to use these 
custom commands. 

One thing that bears consider- 
ing is that Pro Pascal is being up- 
dated and actively supported by 
Prospero, while Personal Pascal 
has languished, with no strong 
marketing force to keep it viable. 
Further, although many of the 
GEM aspects of Personal Pascal 
are easier to use, they are differ- 
ent from the rest of the ST world, 
while Pro Pascal has pretty much 
adhered to the standard. 

Prospero Pascal is a complete, 
high-quality language with superb 
manuals. The wealth of commands, 
VDI and AES bindings, a quality 
editor and the many options and 
extensions make it an excellent 
value, and it is highly recommended 
to the budding (or experienced) 
Pascal programmer.. 




David Plotkin has been pound- 
ing the keys on Atari computers 
for almost ten years, and in that 
time he has written many 
memorable programs and articles. 
He has an MS in chemical en- 
gineering and is a data analyst for 
Chevron Corporation. 
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Disk 1: The American Civil War 
Disk 2: Vietnam 



Rainbird Software 
P.O. Box 2227 
Menio Park, CA 94026 
(415) 322-0412 



Reviewed 
by 

Frank Eva 



The Universal Military Simula- 
tor [UMS\ is a software package 
that will not blow you away 
graphically However, it is an ef- 
ficient tool for the serious war 
gamer or history buff. For those 
who are unfamiliar with this pro- 
gram, perhaps a few brief words 
about the system are in order. 

First of all, UMS depicts histor- 
ical conflicts in the medium and 
high resolution modes of all Atari 
STs, with at least 512K of RAM. 
The high resolution mode is, of 
course, possible only for those 
with monochrome monitors. The 
medium resolution mode limits 
the program to a total of four 
colors, the defaults being black, 
white, green and orange. The 
defaults for high resolution are 
black and white, the normal out- 
put of Atari monochrome moni- 
tors. Because of the color 
limitations, the program relies 
heavily on grid maps, which are 
basically black-on-white line 
drawings that represent contours 
in the landscape only marginally. 

Armies are depicted by unit, 
with the commanding officer's 



name emblazoned on the icon. An 
arrow points to the position of the 
unit on the map. Additionally, a 
smaller icon represents the type 
of unit at that location: i.e., light 
infantry, heavy artillery, etc. 

While limited graphically, UMS 
has the unique ability to depict 
the setting of each battle from any 
direction of view selected by the 
user, as well as the ability to uti- 
lize two levels of zoom. However, 
zooms again do not accomplish 
anything graphically, aside from 
the fact that the enlarged areas 
permit the user to see more clear- 
ly what is going on. A zoom mere- 
ly enlarges the scale of the 
original map and does not display 
anything beyond the field of the 
zoom. It is obvious that UMS was 
not programmed in the style of 
Chris Crawford, the father of 
home computer war games. 

However, the 3-D grid maps do 
give the war gamer a feel, at 
least, for the lay of the land. This 
is a feature that was lacking in 
most of the early war games. Ad- 
ditionally, UMS provides the user 
with the ability to create entirely 
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new scenarios and customized 
maps. This ability has spawned 
the next generation of scenario 
disks for the UMS owner. 

Scenario Dlsl< #1 includes three 
major battles from the American 
Civil War. While the original disk 
included the battle of Gettysburg, 
this new disk provides the battles 
of Shiloh, Chattanooga and Antie- 
tam. The battle of Shiloh presents 
the surprise attack of confeder- 
ate General Albert Sydney John- 
ston's 45,000-man army of the 
Mississippi against the unpre- 
pared forces of Ulysses S. Grant. 
The battle of Chattanooga depicts 
the besieging confederate army 
holding the towering high ground, 
while the union army, with an 
ever dwindling store of supplies, 
held the sleepy Tennessee town 
of Chattanooga. 

The battle of Antietam, Sep- 
tember 17, 1863, is referred to as 
the bloodiest day in the history of 
American arms. Robert E. Lee has 
gambled the future of the Con- 
federacy on an invasion of the 
north. The secret battle plans fall 
into the hands of General George 



B. McClellan, but the issue would 
still have to be decided by over 
150,000 American troops! 

Scenario Disk #2 includes three 
battles from the Vietnam war: Hill 
823, Hill 875 and Ngoh Kam Leat. 
Hill 823 depicts the 4th division's 
mission to clear the region south- 
west of Dak To, since intelligence 
reported that the North Viet- 



namese were gearing up for 
another big thrust there. Hill 875 
was crucial to the battle for Dak 
To. American forces switched 
from attack to defense, as the 
NVA crashed down upon them. 

On the slopes of Ngoh Kam 
Leat, American forces under Cap- 



tain Thomas Baird stumbled into 
a hornet's nest of enemy opposi- 
tion. Despite constant sniper fire, 
ground attacks and significant 
casualties, the American troops 
prevailed. 

The procedure for using sce- 
nario disks is simple. The user 
loads UMS as usual, supplying a 
password from the original sce- 



nario handbook to verify owner- 
ship, and then clicks on the "run 
simulation" button. This brings up 
a selection screen that displays 
the original scenarios and a but- 
ton in the lower right-hand corn- 
er to display scenarios contained 
on another disk. Clicking on this 



button brings up a standard file 
selector. Selecting a file will load 
the simulation from the sup- 
plementary disk. From here on, all 
UMS functions are exactly the 
same as the original. 

By the way, the scenario disks 
are not copy protected. So, they 
may be copied for archival pur- 
poses or loaded onto a hard drive. 

All scenario disk packages are 
accompanied by a detailed sce- 
nario handbook. The American 
Civil War is 80 pages; The Viet- 
nam War is 30 pages. It is obvi- 
ous to this reviewer that many 
hundreds of hours went into the 
preparation of these supplemen- 
tary disks and their accompany- 
ing documentation. Only the most 
dedicated history buff/war gamer 
would be willing to devote so 
much time to such an occupation. 
Now, Rainbird has taken all the 
work out of the process for the 
majority of UMS owners, and 
done it at a very reasonable price! 
Scenario disks have certainly im- 
proved the longevity of a fine tool! 

The bottom line: A good value 
for owners of UMS. 



While limited graphically, UMS has the 
unique ability to depict the setting off 
each battle from any direction off view 
selected by the user, as well as the 
ability to utilize two levels off zoom. 
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Menace 



Psygnosis Ltd. 
First Floor 
Port of Liverpool Building 
Liverpool L3 1BY 
United Kingdom 
$29.95, color only 




Reviewed 
by 

Frank Eva 




In the finest tradition of hori- 
zontally scrolling arcade games 
such as Defender, Gradius and 
Life Force, Menace explodes on 
the 68000 microcomputer scene. 
Using the advanced graphics and 
speed available on the Atari ST 
family of home computers, Psyg- 
nosis has brought arcade enthu- 
siasts a wonderful diversion from 
the action/strategy games they 
have become famous for. At last, 
an intense, albeit mindless, shoot 
'em up that truly utilizes the 68000 
microchip to its fullest! 

Menace's documentation in- 
forms the player that the inhabi- 
tants of the planet Draconia have 
become the most feared and ruth- 
less plunderers of known space. 
Ousted from their home planets, 
they have formed an alliance of ter- 
ror and have taken the planet 
Draconia as their home base. You 
must put an end to their reign of 
terror. 

While a large-scale attack might 
prove too costly, the free worlds 
are always willing to sacrifice a 
single ship and its pilot— you.' Also, 
it is assumed that a single attacker 
might be able to approach almost 
undetected. For this reason, a 



space slug has been captured. Your 
ship will hide in the maw of the 
slug. It will then be controlled re- 
motely, to the planet Draconia. At 
the appropriate time, a signal will 
be sent that will cause the slug's 
mouth to open, at which time you 
will be free to engage the enemy 

Draconia consists of six zones; 
Sea of Karnaugh, Vanguard War- 
zone, Carnage Rift, Tropics of Mace, 
Ruins of Kruger and Plateaus of 
Draconia. Destruction of all six will 
leave the planet totally vulnera- 
ble to attack. 

As mentioned. Menace provides 
six levels of progressive difficulty. 
In addition, two difficulty settings 
are possible: novice and expert. In 
the novice level, only collisions with 
aliens and guardians reduce your 
shields. In the expert level, colli- 
sions with scenery will also reduce 
your shields. What this really 
means is that there are twelve lev- 
els of progressive difficulty. There 
are 60 different animated aliens 
to conquer along the way, and an 
all-powerful "guardian" to combat 
at the end of each level. All of these 
features considered, Menace 
should give you many hours of in- 
teresting play. 



Final Assault 



Epyx 

600 Balveston Drive 
Redwood City, CA 94063 
$29.95, color 



Reviewed 

by I 

Steve Panak 



I'm really not sure how to start 
in on this one, so I'll come right 
to the point. Final Assault is a 
simulation that attempts to recre- 
ate the thrills, spills and chills of 
mountain climbing. Technically, it 
succeeds on nearly every level. 
However, subjectively, I did not 
care much for it, feeling, as I do 
toward most simulations of this 
type (i.e., a fishing simulation I 
played about a year ago): that 
such an activity does not lend it- 
self to computerization. Put sim- 
ply, although technically brilliant, 
something is lost in the trans- 
lation. 

This said, those still interested 
will be pleased to hear that Final 
Assault does a great job. As 
would be done in preparation for 
a real climb, your first task is to 
assemble in your backpack items 
you feel will be of use. The items 
selected will depend on the time 
of day and length of your climb, 
as well as the season and charac- 



teristics of the summit. The 
weight of each item is taken into 
account, so don't overload your- 
self. For instance, a long climb 
would require food, perhaps a tent 
for shelter. Icy climbs require 
crampons (boot spikes) while rock 
climbing might be easier with soft 
shoes. 

There are a number of trails 
available on three mountain 
ranges, enough to keep most 
climbers busy until they are quite 
tired of the program. Although the 
manual included a short section 
on the Alps, one of the most fa- 
mous mountain ranges in the 
world, I was disappointed to dis- 
cover that the actual 'mountains 
you climb seem to have no basis 
in reality However, each is rated 
as to difficulty and estimated time 
for completion. After choosing 
your trail and loading up with 
gear, you head for the hills. 

Play is dis/ided into two main 
classifications: walking and climb- 
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Menace uses ultra-smooth paral- 
lax scrolling to paint its intrigu- 
ing screens. Parallax scrolling 
refers to the slight difference in 
scrolling speed between the fore- 
ground and background. Your eyes 
perceive this difference and trans- 
late it into greater depth, the im- 
pression of a third dimension. 
Disney Studios pioneered this 
technique, which then gave its flat 
cartoon animation some feeling of 
depth. 

Menace features a continuous 
sound track that can be disabled 
when it starts to grate on the 
nerves. Sampled effects and 
speech are also included. 

Both mouse and joystick con- 
trols are allowed. Each are good, 
and neither present any real dif- 
ficulties for the gamer. The high 
scores can be saved to Disk B of 
the two disk set, if the write pro- 
tect tab is placed to "write en- 
able." There is a nice restart 
feature that arcade purists will 
really appreciate. As with arcade 
games such as Lock-On, the play- 
er is allowed to restart at the cur- 
rent level in which his last ship 
was lost. Any special weapons 
collected along the way are lost. 



however, if this option is selected. 

Another nice feature is the 
aforementioned ability to collect 
superior weapons, for use on your 
own craft. The manual justifies 
this by saying that you have on 
board the latest in matter convert- 
er weapons. These weapons al- 
low you to change the molecular 
structure of space debris by con- 
tinually bombarding it with high- 
energy shots. By picking up the 
debris when it is in usable form, 
you may build and replenish ex- 
tra weapons. The computer will 
generate images for you, show- 
ing you when to pick up the 
debris for specific weapons. 

In reality, here is what happens: 
Destroying an entire wave of at- 
tacking Draconians will cause an 
icon to appear on the screen. Fir- 
ing at the icon five times will 
cause it to change into another 
icon depicting a different weapon. 
You may collect the weapon de- 
picted simply by flying over the 
icon. 

Icons are provided for addition- 
al bonus points, cannons (short- 
range weapons), lasers (long-range 
weapons, especially useful against 
guardians) and outriders, The out- 



Menace 




riders are probably the most in- 
teresting and useful. They are 
externally mounted droids that can 
fire at adjustable angles, as op- 
posed to the lasers and cannons 
that can be fired only horizontally. 
Finally, icons representing speed 
boosters, force fields and full 
shield recovery are available. 

While the program disks are 
copy protected, the Menace's 
reasonable price makes up for this 
inconvenience. The animation of 
the on-screen aliens and attack- 



ers is really worth the price of ad- 
mission. Menace is the kind of 
game that makes the ST look so 
much more impressive than Nin- 
tendo and Sega home entertain- 
ment systems. Not that I am 
advocating the ST as a game 
machine, but for those who like 
games, while really needing more 
than a static game machine, it's 
still nice to know that the ST plays 
the best games available today. 
Menace rates a solid Al 
The bottom line: Buy it. 



ing. Climbing is further divided 
into scaling ice and rock, each of 
which requires different tech- 
niques. The use of a rope might 
also be necessary on some of the 
more difficult ridges. On a typical 
trail, it might be necessary to first 
hike to the base of the moun- 
tain—testing the ground with 
your ice pick, jumping over crev- 
ices as they appear— until you 
reach an ice cliff. You'll then 
select the proper gear and start 
your climb. This scaling works 
much the way the old Crazy Clim- 
ber arcade game worked, because 
you use the joystick or keyboard 
to place and move your feet and 
hands. And if you're not careful, 
don't fret: A beginner gets up to 
three lives. An expert should 
know better. Rounding out the 
program is a save-game feature 
that allows you to rest in the mid- 
dle of lengthy climbs, and a log to 
allow you to record your 
achievements. 



The manual is surprisingly com- 
plete and concise; the program 
remarkably easy to learn. While 
I usually find that the translation 
of simple human motions, such as 
walking or climbing, on the com- 
puter requires a frustrating and 
awkward set of unnatural com- 
mands that make learning and 
playing the game a chore. Final 
Assault escapes this trap. While 
it is difficult to learn, I was 
amazed to find that once the mo- 
tions were mastered, they be- 
came almost instinctive, with the 
result that you improved in skill 
until you were confident on even 
the toughest summits. And when 
combined with the informative 
manual, the package teaches the 
neophyte just about everything he 
would want to know about moun- 
tain climbing, which is a fair and 
objective measure of the pro- 
gram's success. 

The bottom line: For simulation 
fans. 
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600 Galveston Drive 
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I've been waiting for this one. 
Not this particular game, mind 
you, but rather for one very much 
like it. And I'm not so sure that 
the correct word shouldn't be 
"dreading." This is because I lack 
the free time to be hooked on 
something like Tower Toppler, the 





latest arcade-action addiction 
from Epyx. 

The premise is simple enough. 
In the middle of a toxic ocean rise 
two sets of eight towers. Your 
goal is to climb each progressively 
more difficult donjon, avoiding a 
whole slew of passive and active 
hazards that confront you. How- 
ever, as these dangers merely 
knock you down, rather than kill 
you outright, and because you 
often catch yourself before you 
take a dip in the deadly waters, 
most players will find the time 
limit to be their most persistent 
enemy 

But what keeps you masochis- 
tically coming back for more are 
the towers themselves. Each one 
is a labyrinth with breakaway trap 
floors, barricades and only one 
way to the top. And even after you 
find the way, you'll need split- 
second timing to do it consistently 
enough to finish all seven towers 
consecutively 

Truly successful arcade games 
require an identifiable protagonist, 
and in this department, Tower 
Toppler excels. True, while the 
small, green, Q-Bert-like creature 
with the huge, expressive eyes 
may not go down in high-resolu- 
tion history as the next Pac-Man 
or Donkey Kong, he is just weird 
enough to grab your attention. 
And if he doesn't enthrall you, the 
superb graphics will. The towers 
rotate smoothly as you circle up 
them, and every item in the game 
is finely shaded and detailed— 
truly arcade quality Control is, 
likewise, sure and precise, and the 
action is supplemented with real- 
istic sound effects and mindless 
music that will hypnotize you 
through hours of plays. As if this 
isn't enough, the bonus rounds 
will provide just the impetus you 
need to complete just one more 
tower before powering down. 

All in all. Tower Toppler is a 
primer on just what makes a 
great arcade program. As I men- 
tioned earlier, you've got the cute 
creature, you've got danger, 
you've got challenge. Just keep in 
mind that once you boot this one 
up, it's unlikely that you do any- 
thing else until it is conquered. 
Consider yourself warned. 
The bottom line: Buy it. 
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Scruples 



by Milton Bradley 
Electronic Arts 
1820 Gateway Drive 
San Mateo, CA 94404 
(415) 571-7171 
$39.95, color only 



It seems so long ago that the 
Trivial Pursuit fad grabbed the 
country. As I predicted at the time 
(and 1 must add that such clair- 
voyance required neither super- 
natural powers nor a hotline to 
the Almighty), the addiction to 
those little cards soon faded. 

But not before a lot of other 
games based on the premise that 
a room fulkof people required a 
stack of such cards simply to en- 
gage in conversation or otherwise 
enjoy themselves popped up on 
department store shelves. Scru- 
ples was one such game. 



Reviewed 

by I 

Steve Pa no k I 



Scruples 




The object of the game is to 
pose a moral dilemma to a per- 
son and force him to answer it to 
the satisfaction of the rest of the 
group. The winner is the player 
who is able to predict who will 
answer each question in a given 
way Such a question might be: 
Would you return a wallet that 
you found on the street, if it con- 
tained $1,000 and no one knew 
you had it? And while I find little 
pleasure in such a contest, a 
number of people do, and did, and 
more power to them. But the 
computer version, or should I say 
perversion, is another thing en- 
tirely 

What I find truly ghastly about 
this game is the fact that you play 
against computer-generated and 
-controlled people, infinitely inferi- 
or to real people. I'll disregard the 
option that allows you to play 
with real people, as I feel, as 
usual, that there is no need to in- 
sert a computer into a game such 
as this. It simply gets in the way 
So the person most likely to play 
the game can best be described 
as follows. 

Presumably the most likely 
player of computerized Scruples 
enjoys the board version of the 
game but can find no one to play 
Scruples with. Possibly he has no 
friends at all. So this lonely per- 
son selects a number of compu- 
ter-generated "friends," who have 
been given ratings in 12 traits 
such as honesty, truthfulness and 
greed. This person then tries to 
predict how his computer friends 
will solve their moral dilemmas. 
What Is even more ludicrous, 
these imaginary people can even 
argue with each other when they 
disagree. And you can argue with 
them, choosing from four canned 
responses. 

But I'm not going to argue with 
you. If you feel that you have to 
play Scruples against a computer, 
run right out and get this game. 
However, I feel that most players 
will immediately realize that the 
main ingredient of this game has 
been removed: the infinite com- 
plexity of human personalities and 
relationships. 

And with this removed, there is 
little left. 

The bottom line: Skip it. 
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REVIEW 



Under the Ice 



Lyric Software 
6 Beach Plum Drive 
Northport, NY 11768 
(516) 754-5570 
Color only 



One of the problems with 
modern military simulations is 
that even if you could be accurate 
without compromising military 
[ secrets, it would be excruciatingly 
boring. Real soldiers and pilots 
I and sailors spend years preparing 




Reviewed 
by 

Robert Goff 



Mat liw Iwlia 



tlm...itwmm LmL.M' 




for a few minutes of battle. Those 
few minutes won't really be much 
fun (or survivable) without the 
years of preparation. So we have 
conflicting goals: to realistically 
simulate something that isn't real- 
ly fun in a fun and exciting way. 
I don't think that Under the Ice 
has found the balance. 

Under the Ice is a single-player 
game that puts you in the role of 
a task force commander (either 
NATD or Soviet) with two or more 
submarines under your direct 
command. You pick the scenario 
and the side you fight on, the 
computer picks your ships and 
your weapons so that each game 
is a little different. Your mission 
is to use your ships to find and 
sink the enemy before he does the 
same to you. 

There are a variety of ship 
classes and weapons. Permit, 
Sturgeon, Los Angeles and Trafal- 
gar class ships on the NATO side 
and Victor 1, Victor 3, Yankee and 
Delta class ships on the Soviet 
side. Different ships carry differ- 
ent combinations of torpedoes 
and missiles. You track the 
progress of your units on a map 
of their patrol area with sensor in- 
formation provided either as lines 
pointing from the detecting plat- 
form toward the contact or, if the 
information is good enough, as 
icons representing the location of 
the enemy ship. To give orders to 
one of your ships, you click on it 
and use the control buttons to 
control weapons, sensors or 
movement. To get information 
about a target, you click the 
mouse on the target on the 
screen. A line at the top of the 
map tells you the class of ship, its 
depth and its speed. After you 
select a target, you can order one 
of your ships to shoot it. 

The game disk itself is un- 
protected. For copy protection, it 
uses a password system where 
the game asks you to type in a 
word from a random place in the 
manual. This method is certainly 
a lot less painful than disk encryp- 
tion, since it leaves you able to 
make your own backups. 

The play of the game is fair. 
Selections under the GEM menu 
bar allow pausing the game and 
changing the time progression. 
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There is no game save, and there 
doesn't seem to be any way to 
restart the game without actual- 
ly quitting the program and run- 
ning it again. There's also a game 
realism switch that determines 
whether you see torpedoes fired 
at you plotted on the map or only 
from the direction they are com- 
ing. The use of the mouse to 
select units to command and tar- 
gets to shoot is a good idea, but 
can be a pain. If you try to select 
one of the ship icons on the map 
but miss by a little, you execute 
a map zoom. 

If you're used to animation that 
moves smoothly, or even semi- 
smoothly, the complete redraw of 
the screen every two seconds will 
annoy you. Having to wait for the 
program to accept commands 
may also drive you nuts. But to 
be fair, this simulation doesn't 
really have to have the instant 
response of an arcade game. 

While controlling the move- 
ment of the ships by entering 
route legs is convenient, there 
doesn't seem to be a way to 
change the current depth or 
speed without deleting all the 
route legs back to your present 
position and entering new ones. 
Very clumsy. The time the ship 
reaches the end of each route leg 
is listed on the screen to allow 
coordinating task force move- 
ment, but since the time isn't 
shown until the leg is defined, it's 
not very useful. 

There are problems in the in- 
formation line that give depth and 
speed at the top of the map. If you 
change depth or speed, it doesn't 
update until you select another 
ship and then go back to the first. 

The simulation is less than fair. 
The capabilities of the different 
classes of submarines are not 
fairly represented by the speeds 
and depths at which they are al- 
lowed to operate. I can only hope 
that their noise levels and sonar 
capabilities are modeled in the 
program to provide a realistic ad- 
vantage of one ship over another. 
The arena of action, a small sec- 
tion of the North Sea, is too limit- 
ed. Finally, the manual attempts 
to give some background and 
hints on tactics, but doesn't go far 
enough. It concentrates on how 



sound propagates in the water 
without telling you how to use 
that information. 

This game has many of the 
strategic aspects of a war game 
and less of the shoot- 'em-up ac- 
tion of the video game. If you like 
a game that is more tactics than 
reflexes, you may enjoy this one. 
If you're looking for an accurate 
submarine simulation, however, 
save your money. ■ 

The bottom line: Get a demon- 
stration first. 




Frank Eva is an auditor by 
profession, but has been involved 
in the computer industry ever 
since his purchase of an Atari 400 
many years ago. He has dabbled 
in programming and has had 
several text adventures published. 




Steve Panak has written more 
game reviews for ST-LOG and 
ANALOG than anyone on the face 
of the earth. He lives in Ohio 
where he plays games on his ST 
and practices law. 



Robert Goff is a part-time free- 
lance author specializing in the 
Atari ST. To pay the bills, he is a 
naval officer with ten years ofex- 
I perience in submarines. 



DON'T MISS 
A SINGLE ISSUE 

Let us know your new ad- 
dress right away. Attach 
an old mailing label in the 
space provided below and 
print your new address 
where indicated. 
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FROM THE MINDS OF THE CODEHEADS COMES 




Run any ST program simply by pressing a "hot" 
key.. .from the ST desldop! 

No more wading through folders to run programs. 

Up to 54 programs may be installed. $39.95 

Load and Save complete sets of programs. 

Run a program by clicking on its name in the HotWire menu or 

by pressing its "hot" key from the menu or desktop! 

Allows full use o( ST desktop features. 

Unique "work file" command line features make HotWire an 

excellent shell for developers. 



MIDIM AX MIDI software for the ST 

The Real-time music performance aid! 

Create strings of MIDI commands triggered by any MIDI event 
Sound like an entire section of instnjments all by yourself! 
Real-time multi-vok;e, multi-channel harnxsnization. 
Single notes can produce chords to 18 notes on any channel(s) 
Instant switching between 8 MIDI chord maps. 4, _ _ 
Turns your ST into an intelligent THRU box. $49.95 
Unlimited keyboard splitting, filtering, and remappi ng . 



jj^MI Tl PCTr UNUMITEO DESK ACCESSORY 
^n^M I m^'^^m. POWER FOR THE ATARI ST 

• Load and use up to 32 accessories or more at any time... 
without retxjoting! 95 

THE POWERFULAND COMPLETE 
REPLACEMENT FOR GDOS 

Join the ranks of users who are free o( GDOS skswdown 
Automatically toad the correct ASSIGN files for each program 

$34.95 



Phone: (213) 386-5735 

Visa and Mastercard accepted. 
Shipping charge: US $2, 
Canada $3, Europe $5. CA 
residents add 6.5% sales tax. 



CodeHead Software 

P.O. Box 74090 

Los Angeles, CA 90004 

(Wa'ra 100% MMmMy languag*!) 




CIRCLE #109 ON READER SERVICE CARD. 



RENTING 



SOFTWARE 



ISN'T 



HARD! 



it's as easy as picking 
up the phone and giving 
your order. If you have 
a credit card, it's even 
easier. The hardest part 
may be waiting for the 
nnail to come! 

We have software for 
Atari, Commodore, 
IBIVI, Apple, 520ST 
and Amiga. 

We're having a special 
sale, with up to 80% 
off selected software. 
Call now for a com- 
plete list. 



Call toll-free outside Texas: 1-800-433-2938 
- Inside Texas call : 81 7-292-7396 

WEDGWOOD RENTAL 

5316Woodway Drive 
Fort Worth, Texas 76133 



CIRCLE #110 ON READER SERVICE CARD. 



The ST-LOG #33 diskeHe contains 28 magazine 
files. They are 

listed 
below. 



FILENAME. EXT FILE TYPE 



O 



CO 
» 



CMANSHIP.ARC contains: 
C33 .PRG RUN FILE 

C33 .C C 

ANIMINPT.ARC containsi 

ANIMINPT.BAS GFA BASIC 
ANIMINPT.LST GFA BASIC 

DRAWITCO.ARC contains: 
DKAW_IT .PRG RUN FILE 
DRAW_IT .LST GFA BASIC 
SHOW_IT .PRG RUN FILE 
SHOW_IT .PHG GFA BASIC 

DRAWITMO.ARC contains: 
MDRAW_IT.PRG RUN FILE 
MSHOW_IT.PRG RUN FILE 

GAMECUPB.ARC contains: 



CUPBOARD. PRG 
CUPBOARD. PI 1 
EIGHT .PIl 
NOUGHT .PIl 
REPEAT .PIl 
ANSWERS .EIT 



RUN FILE 

DEGAS 

DEGAS 

DEGAS 

DEGAS 

DATA 



DRAW IT! COLOR VER. 
SOURCE CODE, ASCII 
SHOW IT! COLOR VER. 
SOURCE CODE, ASCII 



ST GAME CUPBOARD 
PICTURE FILE 
PICTURE FILE 
PICTURE PILE 
PICTURE FILE 
GAME DATA FILE 



GUESSSKH.ARC Contains: 

GUESS .PRG RUN FILE 
H0WT0PLA.DOC TEXT 
(OTHER FILES IN THIS ARC ARE DATA PILEs' 
REQUIRED BY THE GAME.) 

MICROCHK.ARC contains: 



MICROCHK.PRG 
MICROCHK.RSC 
MICROCHK.C C 
MICROCHK.H C 
MICROCHK.DFN DAT 

TIMER. ARC contains: 



TIMERS 

TIMERS 

TIMERS 

INTR 

BI2 

BINT 



README . DOC 
UNAHCHIV.DOC 



ASSEMBLY 
ASSEMBLY 
TEXT 
TEXT 

TEXT 
TEXT 



MICHOCHECK ST 
RESOURCE FILE 
SOURCE CODE 
HEADER FILE 
HCS DATA FILE 



MILLISECOND TIMER 
SOURCE CODE 
SOURCE CODE 
SOURCE CODE 
BATCH FILE 
BATCH FILE 



Disk instructions 
Unarchiving instructions 




Disk instructions: 

Only those files with .PRG, .TOS, or .TTP 
extensions may be run from the GEM desktop. 
Other programs may require additional software 
as shown below. The files on this disk have 
been archived (compressed) into .ARC files. To 
restore the programs to their runnable form, 
follow the instructions Eoutvd in the 
UNARCHIV.DOC file. 

NOTE: due to space limitations, the source code 
for Game Cupboard and for the high res version 
of Draw Itl are not on this disk. If you wish 
to obtain these files, send your original July 
■69 disk (after making a copy; the original will 
be erased), along with a postage-paid mailer to: 

ST-LOG JULY SOURCE CODE 
P.O. BOX H13-M.0. 
MANCHESTER , CT 06040-1413 



WARNING: Be sure to read the appropriate magazine 
article before attempting to run magazine 
files. Failure to do so may yield 
confusing results . 



.EXT DESCRIPTION 

.BAS Requires GFA BASIC 

.LST Requires GFA BASIC 

.C Requires C compiler 

.S Requires 68000 assembler 

.PAS Requires Pascal compiler 
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pc-ditto II 

■ Bv Avant-Garde £ 



By Avant-Garde Systems 







IBM PS/2 30 


Norton SI Rating 






'^^^^^^^^^^^ — ^^~\ — ^ — 
1.8 


Zenith EZ-20 






2.6 






IBM XT 


[- 1.0 


3.0^ 












^ pc-ditto II 



IBM JOL COMPATIBLE ! 

IBMAI PERFORMANCE I 

ATARI PRICE I 



$299.95 



Now! Run the most popular IBM software on your Atari ST... 

FAST ! 



See pc-ditto II at your local Atari dealer or write for free 
information. 



Yes. Please send me more information ! 

I Avant-Garde Systems, 381 Pablo Point Drivei 
Jacksonville, Florida 32225 

! Name 



Address, 

Icity 



_St Zip. 
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I 



by Karl 



W i e g e r s 



t used to be a store that sold hardware 
was someplace you went to buy nails or 
to pick up a pane of glass for the house. 
But times change, and now when you talk 
about a hardware store, you just might be 
referring to the nearby ComputerLand. 
The term hardware has grown to encom- 
pass computers, peripherals like monitors 
and printers, the boards you plug into 
slots in your computer, and even the elec- 
tronic components on the boards. 

Words are funny. When you have an ex- 
pression that contains both an adjective 
and a noun, you can envision a cor- 
responding expression containing an ad- 
jective having the opposite meaning. For 
example, there was no such thing as an 
"acoustic guitar" until someone invented 
the "electric guitar." In this case, I'm think- 
ing of the word software. Software has 
come to refer to the stuff you run on a 
computer, whether it comes from a tape, 
a disk drive, or (if you date back to the 
computer Stone Age) even from switches 
on the computer's front panel. Now you 
can actually go to a "software store," which 
is sort of a white-collar equivalent of the 
old-time hardware store. 

During my reading of computer litera- 
ture, I've encountered all sorts of other 
computerware words. It seems to be 
mighty fashionable to append the suffix 
"ware" to practically any other word to 
create something that sounds both clever 
and computerish. I thought you might be 
interested in hearing some of these. 

The words "hardware" and "software" 
generate very different images in our 
minds. Hardware is tangible, concrete and 
substantial. It has some heft to it. Software 
seems more pliable, ephemeral. Not sur- 
prising, when you figure that software 
consists mostly of some little magnetized 
specks on a piece of plastic. If you look 
at a floppy disk, you can't tell if there's any 
software on it or not. 



But what comes in between? Firmware, 
of course. Firmware is basically software 
in which you have a lot of confidence. You 
create firmware by writing some software 
and then storing it for eternity in the sili- 
con of a ROM chip. No more transient 
magnetic blips for this program! The 
downside is that you can't change the con- 
tents of the ROM, which is why you need 
a lot of confidence in your software be- 
fore firming it up. If you have a bit less 
confidence, you might store it in an 
EPROM, an erasable, programmable, 
read-only, memory chip. It's more con- 
venient than a floppy disk, but reusable 
if your lack of confidence proves 
premature. 

Then there are those companies who 
try to get you all excited about computer 
products that they promise but never 
deliver. Such imaginary stuff is called 
vaporware. Atari Corporation has practi- 
cally made an art form of vaporware, with 
substantial offerings in both the hard and 
soft vaporware categories. Vaporware is 
not limited to the computer world, but 
there sure seems to be more of it there 
(or not there, depending on how you look 
at it) than for other industries. 

Some kind souls don't try to sell you 
anything at all — they give it away. The con- 
tributions of these generous folks are 
referred to as freeware. Public domain pro- 
grams are in the freeware category. While 
there's an awful lot of good freeware avail- 
able, remember that sometimes you get 
what you pay for. 

The next best thing to freeware is share- 
ware. This is the best "ware" word because 
both syllables rhyme. The authors of 
shareware have a sensible attitude. Basi- 
cally, they're saying, "Here. Check this out. 
If you like it, pay me what you feel it's 
worth to you." Donations in the $10 to $20 
range are usually suggested. This is a 
registration fee, which may entitle you to 



future upgrades, printed manuals, etc. 

Shareware authors are trying to get 
some financial reward for their efforts 
without going through the expensive and 
iffy route of commercial publication. 
You're encouraged to give copies of share- 
ware to your friends, who can evaluate it 
and send in their registration fees if they 
use the program. Don't confuse shareware 
and freeware. Shareware shouldn't be con- 
sidered public domain, so if you use it, 
send the guy a few bucks. 

The sad fact is that not every program 
you acquire turns out to be useful. Such 
products become transformed into shelf- 
ware. They can be found sitting quietly on 
your shelves, sometimes still in the origi- 
nal shrink-wrap. I've heard you can deter- 
mine the age of shelfware programs by 
counting the rings in the dust they've col- 
lected (okay, I made this part up). 

Sometimes programs are made avail- 
able to a select group of users before be- 
ing officially released. The idea is to test 
them thoroughly, so that the errors show 
up in friendly hands. This is much less 
traumatic than having genuine customers 
who paid real money discover the bugs. 
Since this second-stage testing is called 
"beta testing," the products naturally are 
referred to as betaware. Product reviewers 
often get a hold of betaware, so they have 
to be careful to inform the reader that 
they weren't testing the official, presuma- 
bly bug-free (ha!) release of the program. 
Programs that don't survive the betaware 
experience may metamorphose into 
vaporware. 

Sometimes you'd like to try out a pro- 
gram before plunking down your cash, es- 
pecially for products in the multi- 
hundred-dollar price range. Some ven- 
dors make this possible by selling at a low 
price or giving away restricted versions of 
the package. For example, a database pro- 
gram may let you set up only a tiny data- 
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base with 20 records or so: enough to see 
how it operates, but not enough to do use- 
ful work. You get the complete program 
when you've paid the full price. Shareware 
can work the same way, with the full fea- 
tures being enabled somehow after your 
registration fee is received. I've heard 
such limited versions )f programs 
referred to as crippleware. 

As computer technology advances, the 
nature of the supporting software evolves. 
Many organizations are linking their per- 
sonal computers through local area net- 
works. Of course, the specialized software 
that runs on networks has to be called net- 
ware. (NetWare is also a registered trade- 
mark of Novell, Inc., which sells products 
for local area networks.) 

One benefit of networking your per- 
sonal computers is enhanced communi- 
cation among human beings. Software 
that facilitates the interactions of a num- 
ber of people is called groupware. Com- 
puter conferencing might be one kind of 
groupware. A word processor that some- 
how lets people work together on the 
same document simultaneously would 
also qualify as groupware. 

People are finding all sorts of ways to 
automate their daily activities. Unfor- 
tunately, most available software addresses 
just one isolated function, rather than be- 
ing an integrated solution to a complex 
job process. If you want to automate a se- 
quence of activities, you probably have to 
pass data from one program to another. 
Software tools to accomplish such linking 
are called bridgeware. Some vendors will 
show you horrendous diagrams depicting 
the clumsy use of bridgeware in a feeble 
attempt to automate your entire work 
process. Then they present their elegant 
integrated system that makes your tangled 
mess obsolete — and for the low, low price 
of just $200,000. (I actually saw just such 
a vendor presentation, with that very 
price.) 

Another hot topic in computing these 
days is hypertext, and programs based on 
hypertext are known as hypenvare. Perhaps 
the most popular example of hyperware 
is Apple's HyperCard for the Macintosh. 
Hypertext is an unusual kind of database, 
in which you store information on a sort 
of electronic index card. A database con- 
sisting of a bunch of cards is called a 
"stack," so another term for hyperware is 
stackware. 

This about covers the different sorts of 
computer wares I have encountered in my 
readings. But the single most important 
thing to remember in your computer tra- 
vails is that old Latin expression caveat 
emptor: let the buyer be-ware. ■ 
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Karl Wiegers is a software engineer in the 
Eastman Kodak Photography Research Labora- 
tories. Although he is obviously well read on the 
subject of "wares," he overlooked the most im- 



portant type: the wonderful programs that can 
be found an this magazine's disk version, which 
are referred to, of course, as "logware." 

ST-LOG invites all authors to submit essays 
for possible use in the Footnotes department. 
Submissions should be between 1,000 and 1,500 
words and may be on any aspect of Atari com- 
puting. Any style or type of essay is acceptable — 
opinion, humor, personal experience — but 
creativity is a plus. Send your submission to: 
Footnotes, c/o STLOG, P.O. Box 1413-M.O., 
Manchester, CT 06040-1413. 



THE ULTIMATE ACTION & ADVENTURE... 




TIME is ticking away as a merciless robot force has 
invaded Akaron. Overwhelming odds are stacked against 
you. Put on your seat belt and Warp into battle... 
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SENSATIONAL GRAPHICS & SPECIAL EFFECTS 
TEN STUNNING & CHANGING LANDSCAPES 
SPECTACULAR SOUND EFFECTS 



P.O. BOX 0457-S, ROCHESTER, Ml 48308-0457 

CALL 1-800-777-1690 TO ORDER, or visit your retailer. To order by mail send a check or 
money order for $39.95 plus $3.00 for fiandling. Please allow 3-5 weeks for delivery. 



CALL 1 -800-731 -1 690 TO ORDER, or visit your retailer. To order by mail send a check or 
money order for $39.95 plus S3. 00 for handling. Please allow 3-5 weeks for delivery. 

CIRCLE #113 ON READER SERVICE CARD. 
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& Computer Enlertainmenl 
. . I P.O. BOX 16927. N. HOLLYWOOD, CA 91615 

n 1 COa Sign me up for 12 issues for only $19.95— I'li save over $15! 

□ Payment Enclosed — Charge My □ VISA □ MC NAME 
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Your first issue will arrive in 6 to 8 weeks. 
Money back on unused subscriptions if not satisfied! WATCH FOR IT!! 
Foreign-add $7 for postage. of,er expires September 27, 1989 
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lANS QUEST 

(from page 59} 

artist's sketch pad as the metaphor and 
each page (screen) can have its own 
palette. They also provide pens, pencils, 
markers, chalk, stump, tracing tools, 
brushes and similar artist's tools. It's an 
unusual way to work but rather more in- 
tuitive if your perception hasn't been 
spoiled by other art programs that more 
or less ignore the graphic arts standards 
in their interface. 

Rovgh has several uncommon com- 
mands, including the viewing of black 
lines only, breakdown of a painting 
("page") into black, yellow, blue and red 
(for producing color separations), anima- 
tion of pages, 3-D arrows, flexible ruler 
(for curves), merge sketches and mask 
parts of sketches. It also has GDOS sup- 
port. More remarkable is Rough's ability 
to handle CAD 3-D V2 objects— retrieve, 
manipulate and copy the image to a 
sketch page. This almost allows Rough to 
be a combination draw/paint program! 

Rough's file-handling capability includes 
Neochrome, DEGAS regular and com- 
pressed. Art Director and GFA Artist 
formats. 

Rough is the best graphic-arts paint pro- 
gram I've encountered, and well worth 
getting when it comes, translated, across 
the ocean. If bundled with its sister pro- 
gram. Lazy Paint, it will be a dynamite 
package. Unfortunately I've only seen 
them as beta English-language versions, 
but what they've done so far is impressive 
and exciting. There is a lot of good soft- 
ware in Europe. 

In the meantime, I'm going to continue 
to doodle with my artware — maybe even 
find a few more to compare — and play 
that highly addictive game, Tetris, from 
Spectrum Holobyte. But more on that 
next time. 




Ian Chadwick is a Toronto-based technical 
writer who lives in an increasingly small home 
with his wife, Susan, six cats, one dog, two rats 
and several field mice {who moved in recently, 
despite the cats) — and that's not to mention the 
neighborhood's stray cats that take up residence 
as the mood moves them. 



98 



ST-LOG JULY 1989 



SAAASH! HITS! 




Looking for some 
real action in home 
computer games? 
Excitement that'll have 
your heart pounding 
and palms sweating? 
Razzle dazzle graphics 
that'll drive you wild? 

Look no further than 
these incredible arcade 
smash hits — now 
faithfully converted for 
your home computer 
by Tengen. 

Speaking of smash, 
Blasteroids® gives a lot 
of space rocks a chance 
to do exactly that to 



your starship. Twist, 
dodge and blast away 
at the never-ending 
onslaught of asteroids 
and enemy ships. But 



one wrong move and 
you'll bite space dust. 

When it comes to 
hits, nothing lets you 
give or take more than 



TEIMGEIM 

WE BRING THE BEST ARCADE HTTS HOME. 

1901 McCarthy Boulevard., Suite 210, Milpitas, CA 95035 (408) 435-2650 
CIRCLE #114 ON READER SERVICE URD. 



Vindicators." It puts you 
in charge of a hyper 
futuristic tank that'll 
blow your mind — 
fighting against enemy 
tanks and turrets that'll 
blow you away. 

Get Tengen's smash 
hits at your favorite 
retailer today. And 
experience the best of 
the arcades at home! 

They're available 
now for the C-64/128, 
Amiga and Atari ST. 

Blasteroids: ® and ©1987, Atari Games Corp. 
Vindicators: TM and ©1988, Atari Games Corp. 
Screen displays for different computers may vary. 
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3MIC STRUGGLE 
jGOOD AND EVIL 

I'l panoramic vision of the caUclyimic itniggle 
(been sidilfully crafted into a liogie computer game 



research and programming have been 
^itive Tolkien computer game." 
6f tiiditional FantatyRoleflaying, War itrategy, and 
let have been ikiilfully blende^for a unique computer 
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of Frodo, Aaragom and Gandaif as they batde to get 
Cracks of Doom. Ranged against you are all the evil forces of 
and the corrupt wizard Saruman. The odds aic 
cannot afford to fail. The destiny of Middle Earth lies 



the 36-screen scrolling map of Middle Earth, wherein are 

cast of 
you 



With the ahnost infinite variety and multiple layers of play, War in Middle 
Earth is a game you can finish in days or weeks, or savor for months. 
It will delight and enthrall, and ultimately become a fim favorite in any 
software library. 
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